CatalystX::Plugin::Engine::FastCGI::Lighttpd - Fix up for FastCGI on Lighttpd.

CatalystX-Plugin-Engine-FastCGI-Lighttpd documentation Contained in the CatalystX-Plugin-Engine-FastCGI-Lighttpd distribution.

Index

Code Index:

NAME

Top

CatalystX::Plugin::Engine::FastCGI::Lighttpd - Fix up for FastCGI on Lighttpd.

VERSION

Top

This document describes CatalystX::Plugin::Engine::FastCGI::Lighttpd version 0.1.0

SYNOPSIS

Top

    # 1. in your MyApp.pm
    use Catalyst qw(+CatalystX::Engine::FastCGI::Lighttpd);

    #    when lighttpd is behind proxy
    __PACKAGE__->config( using_frontend_proxy => 1 );

    # 2. in your lighttpd.conf
    server.error-handler-404 = "DISPATCH_TO_CATALYST"
    fastcgi.server = ( "DISPATCH_TO_CATALYST" =>
                       (( "socket" => "/path/to/myapp.socket",
                          "bin-path" => "/usr/bin/perl /path/to/myapp_fastcgi.pl",
                          "check-local" => "disable" )))

DESCRIPTION

Top

C::E::FastCGI could not treat with PATH_INFO and QUERY_STRING correctly. This module fix up it. mod_proxy of Lighttpd does not set HTTP_X_FORWARDED_HOST. This module fix up it.

SUBROUTINES/METHODS

Top

handle_request( $c, %args )

It rebuild PATH_INFO and QUERY_STRING from REQUEST_URI.

DIAGNOSTICS

Top

Do you want to apply this really?

This module works only on fastcgi-lighttpd.

CONFIGURATION AND ENVIRONMENT

Top

CatalystX::Plugin::Engine::FastCGI::Lighttpd requires no configuration files or environment variables.

DEPENDENCIES

Top

None.

INCOMPATIBILITIES

Top

None reported.

BUGS AND LIMITATIONS

Top

No bugs have been reported.

Please report any bugs or feature requests to bug-catalystx-plugin-engine-fastcgi-lighttpd@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=CatalystX-Plugin-Engine-FastCGI-Lighttpd. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

AUTHOR

Top

Hironori Yoshida <yoshida@cpan.org>

LICENSE AND COPYRIGHT

Top

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

CatalystX-Plugin-Engine-FastCGI-Lighttpd documentation Contained in the CatalystX-Plugin-Engine-FastCGI-Lighttpd distribution. 
#
# $Id$
#
package CatalystX::Plugin::Engine::FastCGI::Lighttpd;
use strict;
use warnings;
use utf8;
use version; our $VERSION = qv('0.1.0');

sub handle_request {
    my ( $c, %args ) = @_;

    my $env_ref = $args{env};

    if ( ( $env_ref->{SERVER_SOFTWARE} || q{} ) !~ /lighttpd/msx ) {
        $c->log->warn( $env_ref->{SERVER_SOFTWARE}
              . ': This plugin should run on Lighttpd.' );
    }

    if ( !$c->engine->isa('Catalyst::Engine::FastCGI') ) {
        $c->log->warn(
            ( ref $c->engine ) . ': This plugin should run on FastCGI.' );
    }

    ( $env_ref->{PATH_INFO}, $env_ref->{QUERY_STRING} ) =
      ( split /\?/msx, $env_ref->{REQUEST_URI}, 2 );

    $env_ref->{HTTP_X_FORWARDED_HOST} ||= $env_ref->{HTTP_X_HOST};

    return $c->next::method(%args);
}

1;

__END__