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.