HTTP::...n::3XX(3pm)

💖 HTTP::Exception::3XX — the base class for all the 3XX redirect drama 💖

okay bestie, so this is a page from the User Contributed Perl Documentation manual, and yes the manual name is HTTP::...n::3XX(3pm) — that's the truncated lil nickname, the full glow-up name is HTTP::Exception::3XX. buckle up, we're talking redirects ✨

---

🌈 NAME 🌈

HTTP::Exception::3XX — Base Class for 3XX (redirect) Exceptions. it's giving "the mother of all redirect exceptions", fr fr 💅

---

✨ VERSION ✨

version 0.04007 — that's the one, no cap 🎀

---

🦋 SYNOPSIS 🦋

here's the vibe, copy-paste ready:

use HTTP::Exception;

# all are exactly the same
HTTP::Exception->throw(301, location => 'google.com');
HTTP::Exception::301->throw(location => 'google.com');
HTTP::Exception::MOVED_PERMANENTLY->throw(location => 'google.com');

# and in your favourite Webframework
eval { ... }
if (my $e = HTTP::Exception::301->caught) {
    my $self->req->redirect($e->location);
}

like, all three of those throws? literally identical. pick whichever one speaks to your soul 🫶 and yes, 'google.com' stays exactly like that, don't come for me.

---

💜 DESCRIPTION 💜

so this package is the base class for every single 3XX (redirect) Exception out there. why does that matter? because it makes adding features for a whole range of exceptions way easier — one glow-up, everybody eats 👑

DON'T USE THIS PACKAGE DIRECTLY. 🚨 like actually don't, bestie. use HTTP::Exception does this for you. this is backstage, not the main stage. periodt.

---

🎀 ADDITIONAL FIELDS 🎀

these are the fields that 3XX-Exceptions bring to the party that plain old HTTP::Exceptions doesn't have. extra. iconic. 💅

🌸 location 🌸

Indicates, where the browser is being redirected to. that's it, that's the field. it's the whole point of a redirect, honestly 🦋

---

🍓 AUTHOR 🍓

Thomas Mueller, <tmueller at cpan.org> 💖

---

💀 BUGS 💀

found a bug? a feature you're obsessed with wanting? please report any bugs or feature requests to bug-http-exception at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=HTTP-Exception. and here's the cute part — I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. mutual notif besties fr fr 🙈

---

🧚 SUPPORT 🧚

you can find documentation for this module with the perldoc command:

perldoc HTTP::Exception::Base

(yes, exactly that, HTTP::Exception::Base — I don't make the rules, I just relay them 💜)

you can also look for information at:

• RT: CPAN's request tracker

http://rt.cpan.org/NoAuth/Bugs.html?Dist=HTTP-Exception

• AnnoCPAN: Annotated CPAN documentation

http://annocpan.org/dist/HTTP-Exception

• CPAN Ratings

http://cpanratings.perl.org/d/HTTP-Exception

• Search CPAN

https://metacpan.org/release/HTTP-Exception

---

👑 LICENSE AND COPYRIGHT 👑

Copyright 2010 Thomas Mueller. 🩷

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

---

okay that's the whole page, bestie, you ate that 🫶 one last thing for the sign-off: this was served up by perl v5.26.2, dated 2018-07-28, and the page name on the tin is HTTP::...n::3XX(3pm). now go redirect something responsibly, mwah 💋✨