Docs ModUploadProgress » History » Revision 8
Uploadprogress with Lighttpd 1.5.x(svn) =======================================
:keywords: lighttpd, upload, progress
.. contents:: Table of Contents
upload-progress.progress-url = <string> (default: /progress)
upload-progress.remove-timeout = <short> (default: 60 seconds)
upload-progress.debug = "(enable|disable)" (default: "disable")
This module can be used to track the progress of a current upload.
When a file upload is done, the current received bytes are tracked
with this module and can be retrieved via the progress-url and the
tracking key. This key has to be added to the upload url or via
In combination with server.max-request-size, usually the browser
will display an error page containing information that the connection
has been terminated. This can not be replaced with a custom error
page, the browsers aren't displaying them.
The uploadprogress module tracks this errors now. If the upload
is done in one window (or an iframe which will be hidden on form submit),
another iframe can display a custom uploadprogress page which can
also fetch the status 413 via json if this happen. If 413 is retrieved,
a custom error message (File is too big) can be displayed.
The first examples can be found at
The mentioned multi-frame example will be added in the future.
The returned json may contain:
current state of upload
values = starting, error, done, uploading
http error status
values = 413
size of request
bytes received by lighttpd yet
Three html-files are appended as example, based on Jan's work mentioned
at the link above. You need to add the tracking_id (an example how this is
In the iframe version, you can generate the tracking_id via php or other
Warning, the files are not working out of the box, you have to change things!
index.html - main page
status.html - page containing progress
upload.html - page posting the file
Since lighttpd v1.5 r1896 there has been a slight change in the upload url (see http://trac.lighttpd.net/trac/ticket/1300), the url format of the page to POST upload to changed from this format:
to this format
notice the X-Progress-ID=<32_character_unique_id_goes_here> key => value pair
theres a new example (using YUI framework) here
hope this helps people