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.