https://github.com/dex4er/deb-libplack-app-proxy-perl

Debian package libplack-app-proxy-perl - Plack::App::Proxy - middleware-aware proxy application for Plack
https://github.com/dex4er/deb-libplack-app-proxy-perl

Last synced: 11 days ago
JSON representation

Debian package libplack-app-proxy-perl - Plack::App::Proxy - middleware-aware proxy application for Plack

• Host: GitHub
• URL: https://github.com/dex4er/deb-libplack-app-proxy-perl
• Owner: dex4er
• Created: 2013-12-02T17:39:09.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2013-12-12T21:52:49.000Z (about 11 years ago)
• Last Synced: 2024-10-28T09:02:12.086Z (about 2 months ago)
• Language: Perl
• Size: 207 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README
  • Changelog: Changes

Awesome Lists containing this project

README

        
NAME

    Plack::App::Proxy - proxy requests

SYNOPSIS

      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);

      };

DESCRIPTION

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

OPTIONS

    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.

MIDDLEWARE CONFIGURATIONS

    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;

      };

AUTHOR

    Lee Aylward

    Masahiro Honma

    Tatsuhiko Miyagawa

    Jesse Luehrs

LICENSE

    This library is free software; you can redistribute it and/or modify it

    under the same terms as Perl itself.

SEE ALSO

    Plack::Builder