Author image יצחק גולדסטנד

NAME

Apache::UploadMeter - Apache module which implements an upload meter for form-based uploads

SYNOPSIS

  (in mod_perl_start.pl)
  use Apache::UploadMeter;
  
  $Apache::UploadMeter::UploadForm='/form.html';
  $Apache::UploadMeter::UploadScript='/perl/upload';
  $Apache::UploadMeter::UploadMeter='/perl/meter';
  
  Apache::UploadMeter::configure;

  (in /form.html)

  <!--#uploadform-->
  <INPUT TYPE="FILE"/>
  <INPUT TYPE="SUBMIT"/>
  </FORM>

DESCRIPTION

Apache::UploadMeter is a mod_perl module which implements a status-meter/progress-bar to show realtime progress of uploads done using a form with enctype=multipart/formdata.

Since the module uses quite a few distinct URIs to run, as well as the need to chain to various parts of the Apache request phase and the need to insert data into existing HTML changes, it might seem a trifle difficult to set up at first glance. However, much effort has been made in minimizing the effort required to do this. All that is needed is to tell the module where the different URLs are during server startup, and Apache::UploadMeter will insert the proper hooks for the different URLs automatically.

The only changes needed to be made to existing pages and/or scripts is the replacement of the existing <FORM> tag, which is done automatically the a special SSI directive <!--#uploadform--> instead of the existing <FORM> tag.

NOTE: To use this, mod_perl MUST be built with StackedHandlers enabled.

AUTHOR AND COPYRIGHT

Copyright (c) 2001 Issac Goldstand <margol@beamartyr.net> - All rights reserved.

This library is free software. It can be redistributed and/or modified under the same terms as Perl itself.

SEE ALSO

perl.