Plack::App::Proxy - proxy requests

       Lee Aylward

       Masahiro Honma

       Tatsuhiko Miyagawa

       Jesse Luehrs

       Plack::App::Proxy is a middleware-aware proxy application for Plack.

       This library is free software; you can redistribute it and/or modify it under  the  same  terms  as  Perl
       itself.

       This  application  is  just  like  a normal PSGI application and is middleware aware, which means you can
       modify proxy requests (and responses) using Plack middleware stack.

       It also supports the following special environment variables:

       plack.proxy.url
           Overrides the proxy request URL.

       plack.proxy.remote
           Overrides the base URL path to proxy to.

       For example, the following builder code allows you to proxy all GET requests for .png paths to the lolcat
       image (yes, a silly example) but proxies to the internal host otherwise.

         my $mw = sub {
             my $app = shift;
             sub {
                 my $env = shift;
                 if ($env->{REQUEST_METHOD} eq 'GET' && $env->{PATH_INFO} =~ /\.png$/) {
                     $env->{'plack.proxy.url'} = 'http://lolcat.example.com/lol.png';
                 }
                 $app->($env);
             };
         };

         use Plack::Builder;

         builder {
             enable $mw;
             Plack::App::Proxy->new(remote => 'http://10.0.0.1:8080')->to_app;
         };

       Plack::App::Proxy - proxy requests

       remote
             Plack::App::Proxy->new(remote => 'http://perl.org')->to_app;

           Specifies the base remote URL to proxy requests to.

             builder {
                 mount "/example",
                     Plack::App::Proxy->new(remote => 'http://example.com/app/foo')->to_app;
             };

           This proxies incoming requests for "/example/bar" proxied to "http://example.com/app/foo/bar".

       preserve_host_header
           Preserves  the  original  Host  header,  which is useful when you do reverse proxying to the internal
           hosts.

       backend
           The HTTP backend to use. This dist comes with "LWP" and "AnyEvent::HTTP"  backends.  "AnyEvent::HTTP"
           is the default if no backend is specified.

       options
           The options for the HTTP backend instance.

       Plack::Builder

perl v5.32.0                                       2021-01-09                             Plack::App::Proxy(3pm)

         use Plack::Builder;

         # proxy all requests for /static to 127.0.0.1:80
         builder {
             mount "/static" => Plack::App::Proxy->new(remote => "http://127.0.0.1:80")->to_app;
         };

         # Call from other app
         my $proxy = Plack::App::Proxy->new->to_app;
         my $app = sub {
             my $env = shift;
             ...
             $env->{'plack.proxy.url'} = $url;
             $proxy->($env);
         };