NAME¶
Catalyst::Request::Upload - handles file upload requests
SYNOPSIS¶
my $upload = $c->req->upload('field');
$upload->basename;
$upload->copy_to;
$upload->fh;
$upload->filename;
$upload->headers;
$upload->link_to;
$upload->size;
$upload->slurp;
$upload->tempname;
$upload->type;
To specify where Catalyst should put the temporary files, set the 'uploadtmp'
option in the Catalyst config. If unset, Catalyst will use the system temp
dir.
__PACKAGE__->config( uploadtmp => '/path/to/tmpdir' );
See also Catalyst.
DESCRIPTION¶
This class provides accessors and methods to handle client upload requests.
METHODS¶
$upload->new¶
Simple constructor.
$upload->copy_to¶
Copies the temporary file using File::Copy. Returns true for success, false for
failure.
$upload->copy_to('/path/to/target');
$upload->fh¶
Opens a temporary file (see tempname below) and returns an IO::File handle.
$upload->filename¶
Returns the client-supplied filename.
Returns an HTTP::Headers object for the request.
$upload->link_to¶
Creates a hard link to the temporary file. Returns true for success, false for
failure.
$upload->link_to('/path/to/target');
$upload->size¶
Returns the size of the uploaded file in bytes.
$upload->slurp¶
Returns a scalar containing the contents of the temporary file.
Note that this will cause the filehandle pointed to by
"$upload->fh" to be reset to the start of the file using seek and
the file handle to be put into binary mode.
$upload->basename¶
Returns basename for "filename".
$upload->tempname¶
Returns the path to the temporary file.
$upload->type¶
Returns the client-supplied Content-Type.
Provided by Moose
AUTHORS¶
Catalyst Contributors, see Catalyst.pm
COPYRIGHT¶
This library is free software. You can redistribute it and/or modify it under
the same terms as Perl itself.