NAME
ASP4::FileUpload - Simple interface for handling File Uploads
SYNOPSIS
# In your handler:
sub
run {
my
(
$s
,
$context
) =
@_
;
if
(
my
$file
=
$Request
->FileUpload(
'fieldname'
) ) {
# Save the file:
$file
->SaveAs(
'/var/media/uploads/budget.csv'
);
# Some info about it:
warn
$file
->UploadedFileName;
# C:\Users\billg\budget.csv
warn
$file
->FileName;
# budget.csv
warn
$file
->FileExtension;
# csv
warn
$file
->FileSize;
# 273478 (Calculated via (stat(FH))[7] )
warn
$file
->ContentType;
# text/csv
warn
$file
->FileContents;
# (The contents of the file)
my
$ifh
=
$file
->FileHandle;
# A normal, plain old filehandle
}
}
DESCRIPTION
This class provides a simple interface to uploaded files in ASP4.
PUBLIC PROPERTIES
UploadedFileName
The name of the file - as uploaded by the user. For example, if the user was on Windows, it might look like C:\Users\billg\Desktop\file.txt
Filename
The name of the file itself - eg: file.txt
FileExtension
If the filename is file.txt
, FileExtension
would return txt
.
FileSize
The size of the uploaded file in bytes.
FileHandle
Returns a filehandle (open for reading) pointing to the uploaded file.
ContentType
The content-type
header supplied by the browser for the uploaded file.
FileContents
The contents of the uploaded file.
PUBLIC METHODS
SaveAs( $path )
Writes the contents of the uploaded file to $path
. Will throw an exception if something goes wrong.
BUGS
It's possible that some bugs have found their way into this release.
Use RT http://rt.cpan.org/NoAuth/Bugs.html?Dist=ASP4 to submit bug reports.
HOMEPAGE
Please visit the ASP4 homepage at http://0x31337.org/code/ to see examples of ASP4 in action.