Dancer2...:Upload(3)

💖 Dancer2::Core::Request::Upload — the vibe check 💖

okay so bestie, welcome to Dancer2::Core::Request::Upload, part of the User Contributed Perl Documentation collection 🎀 this is where Dancer2 keeps the lil class that represents your file uploads, and honestly? it's giving tidy. it's giving organized. we're obsessed 💅

---

✨ VERSION ✨

version 2.2.1 — yes queen, that's the one 🌸

---

🦋 DESCRIPTION 🦋

so basically this class implements a whole representation of file uploads for Dancer2. like, every uploaded file gets its own lil object, and you can grab them inside your route handlers with the request->uploads keyword 🫶

want the deets on how that works? go peek at Dancer2::Core::Request, it's all there. iykyk ⭐

---

👑 ATTRIBUTES 👑

🌸 filename

the filename as sent by the client. it's optional. but heads up — it may not be undef 😭

🧚 tempname

the name of the temporary file the data got saved to. optional too. and also may not be undef bestie, we don't do that here 💀

🎀 headers

a hash ref of the headers that came along with this upload. optional. it is read-write and it's a HashRef ✨

💜 size

the size of the upload, in bytes. optional. that's it, that's the whole thing 🍓

---

🔥 METHODS 🔥

💖 my $filename=$upload->filename;

hands you back the filename (full path) as sent by the client. no cap 📁

🌈 my $tempname=$upload->tempname;

hands you back the name of the temporary file the data has been saved to.

for example, in directory /tmp, and given a random name, with no file extension. cute lil anonymous temp file energy 🥺

⭐ my $href=$upload->headers;

hands you back a hashRef of the headers associated with this upload. slay 💅

🦋 my $fh=$upload->file_handle;

hands you back a read-only file handle on the temporary file. read-only means read-only bestie, don't try it 🙈

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

copies the temporary file using File::Copy. returns true for success, false for failure. simple as 🫶

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

creates a hard link to the temporary file. returns true for success, false for failure. linky link 🔗

🌸 my $content=$upload->content;

hands you back a scalar containing the contents of the temporary file. the whole thing, in one lil string 💖

🧚 my $basename=$upload->basename;

hands you back the basename for "filename". like, just the name part, no directory drama ✨

👑 $upload->type

hands you back the Content-Type of this upload. main character metadata moment 💅

---

💫 SEE ALSO 💫

• Dancer2 — go read it, it's iconic

---

🌈 AUTHOR 🌈

Dancer Core Developers — absolute legends, every single one 👑

---

🍓 COPYRIGHT AND LICENSE 🍓

this software is copyright (c) 2026 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. so like, go forth and remix bestie 🫶

---

and that's the whole page! perl v5.42.3, dated 2026-09-20, from the Dancer2...:Upload(3) files 💅 mwah, stan a well-documented upload class ✨🎀🦋