NAME

       Plack::Middleware::Recursive - Allows PSGI apps to include or forward requests recursively

SYNOPSIS

         # with Builder
         enable "Recursive";

         # in apps
         my $res = $env->{'plack.recursive.include'}->("/new_path");

         # Or, use exceptions
         my $app = sub {
             # ...
             Plack::Recursive::ForwardRequest->throw("/new_path");
         };

DESCRIPTION

       Plack::Middleware::Recursive allows PSGI applications to recursively include or forward requests to other
       paths. Applications can make use of callbacks stored in "$env->{'plack.recursive.include'}" to include
       another path to get the response (whether it's an array ref or a code ref depending on your application),
       or throw an exception Plack::Recursive::ForwardRequest anywhere in the code to forward the current
       request (i.e. abort the current and redo the request).

EXCEPTIONS

       This middleware passes through unknown exceptions to the outside middleware stack, so if you use this
       middleware with other exception handlers such as Plack::Middleware::StackTrace or
       Plack::Middleware::HTTPExceptions, be sure to wrap this so Plack::Middleware::Recursive gets as inner as
       possible.

AUTHORS

       Tatsuhiko Miyagawa

       Masahiro Honma

SEE ALSO

       Plack Plack::Middleware::HTTPExceptions

       The idea, code and interface are stolen from Rack::Recursive and paste.recursive.