| Plack-App-Proxy documentation | Contained in the Plack-App-Proxy distribution. |
Plack::App::Proxy - proxy requests
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);
};
Plack::App::Proxy is a middleware-aware proxy application for Plack.
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.
Preserves the original Host header, which is useful when you do reverse proxying to the internal hosts.
The HTTP backend to use. This dist comes with LWP and AnyEvent::HTTP
backends. AnyEvent::HTTP is the default if no backend is specified.
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:
Overrides the proxy request URL.
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;
};
Lee Aylward
Masahiro Honma
Tatsuhiko Miyagawa
Jesse Luehrs
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
| Plack-App-Proxy documentation | Contained in the Plack-App-Proxy distribution. |
package Plack::App::Proxy; use strict; use parent 'Plack::Component'; use Plack::Util::Accessor qw/remote preserve_host_header backend/; use Plack::Request; use Plack::Util; use HTTP::Headers; our $VERSION = '0.19'; sub prepare_app { my $self = shift; $self->backend($ENV{PLACK_PROXY_BACKEND} || 'AnyEvent::HTTP') unless defined $self->backend; } # hop-by-hop headers (see also RFC2616) my @hop_by_hop = qw( Connection Keep-Alive Proxy-Authenticate Proxy-Authorization TE Trailer Transfer-Encoding Upgrade ); sub filter_headers { my $self = shift; my ( $headers ) = @_; # Save from known hop-by-hop deletion. my @connection_tokens = $headers->header('Connection'); # Remove hop-by-hop headers. $headers->remove_header( $_ ) for @hop_by_hop; # Connection header's tokens are also hop-by-hop. for my $token ( @connection_tokens ){ $headers->remove_header( $_ ) for split /\s*,\s*/, $token; } } sub build_url_from_env { my($self, $env) = @_; return $env->{'plack.proxy.url'} if exists $env->{'plack.proxy.url'}; my $url = $env->{'plack.proxy.remote'} || $self->remote or return; # avoid double slashes $url =~ s!/$!! unless $env->{SCRIPT_NAME} && $env->{SCRIPT_NAME} =~ m!/$!; $url .= $env->{PATH_INFO} || ''; $url .= '?' . $env->{QUERY_STRING} if defined $env->{QUERY_STRING} && length $env->{QUERY_STRING} > 0; return $url; } sub build_headers_from_env { my($self, $env, $req) = @_; my $headers = $req->headers->clone; $headers->header("X-Forwarded-For" => $env->{REMOTE_ADDR}); $headers->remove_header("Host") unless $self->preserve_host_header; $self->filter_headers( $headers ); # Just assume HTTP::Headers is a blessed hash ref +{%$headers}; } sub call { my ($self, $env) = @_; unless ($env->{'psgi.streaming'}) { die "Plack::App::Proxy only runs with the server with psgi.streaming support"; } my $url = $self->build_url_from_env($env) or return [502, ["Content-Type","text/html"], ["Can't determine proxy remote URL"]]; # TODO: make sure Plack::Request recalculates psgi.input when it's reset my $req = Plack::Request->new($env); my $headers = $self->build_headers_from_env($env, $req); my $method = $env->{REQUEST_METHOD}; my $content = $req->content; my $backend_class = Plack::Util::load_class( $self->backend, 'Plack::App::Proxy::Backend' ); return $backend_class->new( url => $url, req => $req, headers => $headers, method => $method, content => $content, response_headers => sub { $self->response_headers(@_) }, )->call($env); } sub response_headers { my ($self, $ae_headers) = @_; my $headers = HTTP::Headers->new( map { $_ => $ae_headers->{$_} } grep {! /^[A-Z]/} keys %$ae_headers ); $self->filter_headers( $headers ); my @headers; $headers->scan( sub { push @headers, @_ } ); return @headers; } 1; __END__