Plack::App::Cascade(3pm)

Plack::App::Cascade3pm

Cascadable compound application

Usage

  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;

Overview

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.

Releases

8 releases since Debian 6.0 (Squeeze); the text changed 7 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13

Author

Tatsuhiko Miyagawa

From libplack-perl 1.0051-1 in Debian 13 (Trixie). Parsed by carta from the page's man source.