/ 
Plack-0.9983
⭐ Starred 488
/ Plack::App::Cascade
Security Advisories (4)
CPANSA-Plack-2015-0202 (2015-02-02)

Fixed a possible directory traversal with Plack::App::File on Win32.

CPANSA-Plack-2014-0801 (2014-08-01)

Plack::App::File would previously strip trailing slashes off provided paths. This in combination with the common pattern of serving files with Plack::Middleware::Static could allow an attacker to bypass a whitelist of generated files

CPANSA-Plack-2013-0131 (2013-01-31)

Fixed directory traversal bug in Plack::App::File on win32 environments

CVE-2026-7381 (2026-04-29)

Plack::Middleware::XSendfile versions through 1.0053 for Perl can allow client-controlled path rewriting. Plack::Middleware::XSendfile allows the variation setting (sendfile type) to be set by the client via the X-Sendfile-Type header, if it is not considered in the middleware constructor or the Plack environment. A malicious client can set the X-Sendfile-Type header to "X-Accel-Redirect" to services running behind nginx reverse proxies, and then set the X-Accel-Mapping to map the path to an arbitrary file on the server. Since 1.0053, Plack::Middleware::XSendfile is deprecated and will be removed from future releases of Plack. This is similar to CVE-2025-61780 for Rack::Sendfile, although Plack::Middleware::XSendfile has some mitigations that disallow regular expressions to be used in the mapping, and only apply the mapping for the "X-Accel-Redirect" type.

NAME

Plack::App::Cascade - Cascadable compound application

SYNOPSIS

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;

DESCRIPTION

Plack::App::Cascade is a Plack middleware component that compounds several apps and tries them to return the first response that is not 404.

METHODS

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

Creates a new Cascade application.

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

Appends a new application to the list of apps to try. You can pass the multiple apps to the one add call.

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

Sets which error codes to catch and process onwards. Defaults to 404.

AUTHOR

Tatsuhiko Miyagawa

SEE ALSO

Plack::App::URLMap Rack::Cascade