Dancer::HTTP(3pm)

✨ Dancer::HTTP 💖

okay bestie, real talk: this is the helper for rendering HTTP status codes for Dancer. she's tiny, she's powerful, she's the girl who always knows exactly what number to say when things go wrong. iykyk. 🌸

she lives in Dancer::HTTP, she's a Perl module, and honestly? iconic behavior only.

---

🎀 VERSION

version 1.3522 — yeah she's from the 1.35xx era and she's still serving. no cap. 💅

---

🦋 DESCRIPTION

bestie it's literally in the name: this is a helper for rendering HTTP status codes for Dancer. that's the whole gig. that's her whole personality and she's thriving. ✨

---

👑 METHODS

🌈 status( $status )

returns the numerical status of $status. like, you hand her a vibe and she hands you back the digits. 🍓

check it — all three of these are equivalent, and all three return '405':

# all three are equivalent, and will return '405'

$x = Dancer::HTTP->status( 405 );
$x = Dancer::HTTP->status( 'Method Not Allowed' );
$x = Dancer::HTTP->status( 'method_not_allowed' );

so yes bestie you can feed her the number, the fancy name, or the lowercase underscore version and she gets it EVERY time. main character energy fr fr. 💜

🌸 codes

returns a hashref of every HTTP status known to "Dancer". the keys are the numerical statuses and the values are their string equivalents. that's the whole mapping, one big lookup table, gorgeous. ✨

print Dancer::HTTP->codes->{404}; # prints 'File Not Found'

look at that. 404 walks in and 'File Not Found' walks out. chef's kiss. 😭

---

💅 HTTP CODES

so here's the tea ☕: the following codes/aliases are understood by any status() call made from a Dancer script. the aliases can be used as-is (e.g., Moved Permanently), or as a lower-case string with all non-alphanumerical characters changed to underscores (e.g., moved_permanently). either way, she understands you. she always does. 🫶

here's the demo that makes it click:

get '/user/:user' => sub {
    my $user = find_user( param('user') );

    unless ( $user ) {
        status 404;

        # or could be
        status 'not_found';

        # or even
        status 'Not Found';
    }

    ...
};

three different ways to say the same thing and honestly that's so valid of her. pick your fave, she doesn't judge. 💖

⭐ Processed Codes

the "yes girl, we handled it" squad:

• 200 — OK
• 201 — Created
• 202 — Accepted
• 204 — No Content
• 205 — Reset Content
• 206 — Partial Content

🧚 Redirections

the "not here, go there" crew:

• 301 — Moved Permanently
• 302 — Found
• 304 — Not Modified
• 306 — Switch Proxy

💀 Problem with request

aka "bestie, that's on you":

• 400 — Bad Request
• 401 — Unauthorized
• 402 — Payment Required
• 403 — Forbidden
• 404 — Not Found
• 405 — Method Not Allowed
• 406 — Not Acceptable
• 407 — Proxy Authentication Required
• 408 — Request Timeout
• 409 — Conflict
• 410 — Gone
• 411 — Length Required
• 412 — Precondition Failed
• 413 — Request Entity Too Large
• 414 — Request-URI Too Long
• 415 — Unsupported Media Type
• 416 — Requested Range Not Satisfiable
• 417 — Expectation Failed

🙈 Problem with server

aka "okay that one's on us":

• 500 — Internal Server Error
  • also aliases as 'error' 👀 (very "we don't have time to type the whole thing" of her)
• 501 — Not Implemented
• 502 — Bad Gateway
• 503 — Service Unavailable
• 504 — Gateway Timeout
• 505 — HTTP Version Not Supported

---

🎀 AUTHOR

this module has been written by Alexis Sukrieh <sukria@cpan.org> 💖

---

🌈 SOURCE CODE

the source code for this module is hosted on GitHub <https://github.com/PerlDancer/Dancer> — go look, it's giving open source excellence. 🦋

---

🔥 LICENSE

this module is free software and is published under the same terms as Perl itself. slay. ✨

---

💜 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. periodt. 💅

---

okay that's the whole page bestie, you read all of it, i'm so proud of you 🥹

and that's a wrap on Dancer::HTTP, page 3pm, from the User Contributed Perl Documentation collection, generated with perl v5.40.1 back on 2026-05-05. go render some status codes, you absolute icon. 💖✨🎀🦋🌸💅🫶