---
name: "Dancer::Request::Upload"
section: "3pm"
platform: "linux"
package: "libdancer-perl"
version: "1.3521+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Dancer::Request::Upload"
---

# Dancer::Request::Upload(3pm)

class representing file uploads requests

## NAME

Dancer::Request::Upload - class representing file uploads requests

## VERSION

version 1.3521

## SYNOPSIS

```
    # somewhere in your view:
    <form action="/upload" method="POST" enctype="multipart/form-data">
      <input type="file" name="filename">
      <input type="submit">
    </form>

    # and then in your application handler:
    post '/upload' => sub {
      my $file = request->upload('filename');
      $file->copy_to($upload_dir);  # or whatever you need
    };
```

## DESCRIPTION

This class implements a representation of file uploads for Dancer. These objects are accessible within route handlers via the request-\>uploads  keyword. See Dancer::Request for details.

## METHODS

- filename

  Returns the filename as sent by the client.

- basename

  Returns basename for "filename".

- tempname

  Returns the name of the temporary file the data has been saved to.

  This will be in e.g. /tmp, and given a random name, with no file extension.

- link\_to

  Creates a hard link to the temporary file. Returns true for success, false for failure.

  ```
      $upload->link_to('/path/to/target');
  ```

- file\_handle

  Returns a read-only file handle on the temporary file.

- content

  Returns a scalar containing the contents of the temporary file.

- copy\_to

  Copies the temporary file using File::Copy. Returns true for success, false for failure.

  ```
      $upload->copy_to('/path/to/target')
  ```

- size

  The size of the upload, in bytes.

- headers

  Returns a hash ref of the headers associated with this upload.

- type

  The Content-Type of this upload.

## AUTHORS

This module as been written by Alexis Sukrieh, heavily based on Plack::Request::Upload. Kudos to Plack authors.

## SEE ALSO

Dancer

## AUTHOR

Dancer Core Developers

## COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Alexis Sukrieh.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.