NAME

Catalyst::TraitFor::Request::ProxyBase - Replace request base with value passed by HTTP proxy

SYNOPSIS

            

              
              
package MyApp;
use Moose;
use namespace::autoclean;
use Catalyst;
use CatalystX::RoleApplicator;
extends 'Catalyst';
__PACKAGE__->apply_request_class_roles(qw/
    Catalyst::TraitFor::Request::ProxyBase
/);
__PACKAGE__->setup;
            
          

DESCRIPTION

This module is a Moose::Role which allows you more flexibility in your application's deployment configurations when deployed behind a proxy.

The problem is that there is no standard way for a proxy to tell a backend server what the original URI for the request was, or if the request was initially SSL. (Yes, I do know about X-Forwarded-Host, but they don't do enough)

This creates an issue for someone wanting to deploy the same cluster of application servers behind various URI endpoints.

Using this module, the request base ($c->req->base) is replaced with the contents of the X-Request-Base header, which is expected to be a full URI, for example:

            

              
              
http://example.com
https://example.com
http://other.example.com:81/foo/bar/yourapp
            
          

This value will then be used as the base for uris constructed by $c->uri_for.

In addition the request uri ($c->req->uri) will reflect the scheme and path specifed in the header.

REQUIRED METHODS

base

secure

WRAPPED METHODS

base

secure

APACHE SETUP

On the frontend Proxy Apache, you would want to enable a Virtualhost config somewhat like this. The backend apache config stays unchanged.

            

              
              
<Virtualhost *:80>
    ProxyRequests Off
    <Location /preview>
        # You must have mod_headers enabled for that
        # RequestHeader set X-Request-Base /preview
        RequestHeader set X-Request-Base http://www.example.com/preview
    </Location>
    ProxyPass /preview http://my.vpn.host/
    ProxyPassReverse /preview http://my.vpn.host/
</Virtualhost>
            
          

BUGS

Probably. Patches welcome, please fork from:

            

              
              
http://github.com/bobtfish/catalyst-traitfor-request-proxybase
            
          

and send a pull request.

AUTHORS

Tomas Doran (t0m) <bobtfish@bobtfish.net>

CONTRIBUTORS

Klaus Ita (koki) <klaus@worstofall.com>

COPYRIGHT

This module is Copyright (c) 2009 Tomas Doran and is licensed under the same terms as perl itself.