Plack::...:Cascade(3)

✨ NAME ✨

Plack::App::Cascade — a Cascadable compound application 💅 (that's the page title up there in the header, bestie, and the manual name is Plack::...:Cascade(3), from the User Contributed Perl Documentation collection 🎀)

---

🌈 SYNOPSIS 🌈

okay so here's the whole vibe in code, no cap:

use Plack::App::Cascade;
use Plack::App::URLMap;
use Plack::App::File;

# Serve static files from multiple search paths
my $cascade = Plack::App::Cascade->new;
$cascade->add( Plack::App::File->new(root => "/www/example.com/foo")->to_app );
$cascade->add( Plack::App::File->new(root => "/www/example.com/bar")->to_app );

my $app = Plack::App::URLMap->new;
$app->map("/static", $cascade);
$app->to_app;

like… serving static files from multiple search paths?? the way that just works 🦋 iconic behavior fr fr

---

💖 DESCRIPTION 💖

Plack::App::Cascade is a Plack middleware component that compounds several apps together and tries them one by one, returning the first response that is not 404. it's giving "I'll ask literally everyone until somebody answers me" 😭 and honestly? slay.

---

👑 METHODS 👑

🌸 new

$app = Plack::App::Cascade->new(apps => [ $app1, $app2 ]);

Creates a new Cascade application. that's it, that's the birth story 🫶

🎀 add

$app->add($app1);
$app->add($app2, $app3);

Appends a new application to the list of apps to try. and bestie, you can pass multiple apps to the one add call — go off, be efficient 💅

🦋 catch

$app->catch([ 403, 404 ]);

Sets which error codes to catch and process onwards. Defaults to 404. so if you want 403 in the mix too, you gotta say so yourself ✨

---

💜 AUTHOR 💜

Tatsuhiko Miyagawa</purl> — the original main character, we respect it 👑

---

⭐ SEE ALSO ⭐

• Plack::App::URLMap
• Rack::Cascade

iykyk 🧚

---

and that's the whole page, bestie!! this was perl v5.42.3, dated 2026-10-18, from the Plack::...:Cascade(3) manual — go forth and cascade ur little heart out 💖✨🎀🦋🌸💅