HTTP::...direct(3pm)

📦
version 0.028 · 2 versions
  • 0.028 · debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking (latest)
  • 0.027 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu resolute, ubuntu stonking

💅 HTTP::Throwable::Role::Status::TemporaryRedirect

okay bestie, welcome to the perl manual page for HTTP::Throwable::Role::Status::TemporaryRedirect — aka the role that gives you the 307 Temporary Redirect status. yes it's a whole vibe, no cap. it's part of the HTTP::Throwable situation and it's literally here to explain what a 307 means and how you should act when you see one. let's get into it 🦋

✨ VERSION ✨

version 0.028 — that's the one, that's the era we're in 💖

🌸 DESCRIPTION 🌸

so here's the tea: the resource you asked for is temporarily chillin' somewhere else, under a different URI. it's not a permanent move, it's a "brb" situation, not a "moved out and changed their number" situation.

since that redirection MAY get switched up sometimes (it's giving unpredictable, honestly), the client SHOULD keep using the Request-URI for future requests. like, don't go rewriting your whole address book over this, okay? 🙈

also important: this response is only cacheable if it says so via a Cache-Control or Expires header field. no header, no caching. periodt.

the temporary URI SHOULD be handed over in the Location field of the response. that's the whole point, that's the moment.

and unless the request method was HEAD, the entity of the response SHOULD contain a short hypertext note with a hyperlink to the new URI(s) — because, and this is the key part, many pre-HTTP/1.1 user agents do not understand the 307 status. they're out here living in the past and they simply will not get it. 💀

therefore, that note SHOULD contain all the info necessary for a user to repeat the original request on the new URI. basically: leave a breadcrumb trail, bestie. make it repeatable. don't leave anyone stranded. 🫶

🐚 PERL VERSION 🐚

this library should run on perls released even a long time ago. she's flexible like that. it should work on any version of perl released in the last five years. iconic behavior, honestly.

although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. it can go up for literally any reason. and there is no promise that patches will be accepted to lower that minimum. so don't come in asking to lower it, that's not the move. 😭

👑 AUTHORS 👑

the legends responsible for this masterpiece:

  • Stevan Little <stevan.little@iinteractive.com>
  • Ricardo Signes <cpan@semiotic.systems>

two icons, one manpage. we love to see it 💜

this software is copyright (c) 2011 by Infinity Interactive, Inc.

it's free software, fr fr — you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. slay.

okay that's the whole page, we ate and left no crumbs ✨ this was HTTP::Throwable::Role::Status::TemporaryRedirect version 0.028, straight out of the perl v5.36.0 toolchain, dated 2023-01-24. go forth and redirect responsibly, bestie 💅🌈

📦 where this page comes from