CGI::FileUpload - A module to upload file through CGI asynchrnously, know where the upload status and get back the file from a third parties on the server
An uploaded file is associated with a key (corresponding to a file in a server temp directory)
When uploading is started the key is returned before the uploading completed, allowing further queries such as knowing is the upload is completed, uploaded file size etc...
use CGI::FileUpload; my $fupload = CGI::FileUpload->new(); ...
Returns the session upload directory (by default is $CGI_FILEUPLOAD_DIR or /defaulttempdir/CGI-FileUpload)
Returns a html <FORM> string such as <form name='cgi_fileupload' method='post' enctype='multipart/form-data'> <input type='file' name='uploadfile'/> <input type='hidden' name='action' value='upload'/> <input type='hidden' name='return_format' value='text'/> <input type='submit' value='upload'> </form>
Parameters can be of
Either retrieves the id cookie or build one based one random number + ip
Creates a new instance in the temp directory
Creates a file (thus returns a key)ending with .string
Read info for an existing file being (or having been) uploaded.
returns the reference key
Returns the originated IP address
Returns some user id (hidden in a randomized cookie)
Returns a string '(uploading|completed|killed)'
Returns a Util::Properties object associated (containing status and whatever info
Returns the local file associated with the uploaded file
Start the upload. A CGI::query must be passed. Other optional arguments can be of
Removes the file upload structure from the temp directory
Kill the uploading process (default signal is 'INT')
<alexandre.masselot at genebio.com>
Please report any bugs or feature requests to
bug-cgi-fileupload at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CGI-FileUpload. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
You can find documentation for this module with the perldoc command.
You can also look for information at:
Copyright 2007 Alexandre Masselot, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.