GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CATALYST::ENGINE::PSGI (3)

.ds Aq ’

NAME

Catalyst::Engine::PSGI - PSGI engine for Catalyst

CONTENTS

WARNINGS

<B>Catalyst 5.9000 or later has a built-in PSGI support and this module is deprecated.B>

SYNOPSIS



  # app.psgi
  use strict;
  use MyApp;

  MyApp->setup_engine(PSGI);
  my $app = sub { MyApp->run(@_) };



DESCRIPTION

Catalyst::Engine::PSGI is a Catalyst Engine that adapts Catalyst into the PSGI gateway protocol.

COMPATIBILITY

o Currently this engine works with Catalyst 5.8 (Catamoose) or newer.
o Your application is supposed to work with any PSGI servers without any code modifications, but if your application uses $c->res->write to do streaming write, this engine will buffer the ouput until your app finishes.

To do real streaming with this engine, you should implement an IO::Handle-like object that responds to getline method that returns chunk or undef when done, and set that object to $c->res->body.

Alternatively, it is possible to set the body to a code reference, which will be used to stream content as documented in the PSGI spec.

o When your application runs behind the frontend proxy like nginx or lighttpd, this Catalyst engine doesn’t automatically recognize the incoming headers like X-Forwarded-For, because respecting these headers by default causes a potential security issue.

You have to enable Plack::Middleware::ReverseProxy or Plack::Middleware::ForwardedHeaders to automatically promote those forwarded headers into REMOTE_ADDR hence IP address of the request.

ReverseProxy middleware is pretty simple and has no configuration while ForwardedHeaders allows you to configure which upstream host to trust, etc.

AUTHOR

Tatsuhiko Miyagawa <miyagawa@bulknews.net>

Most of the code is taken and modified from Catalyst::Engine::CGI.

LICENSE

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

SEE ALSO

Catalyst::Engine PSGI Plack
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CATALYST::ENGINE::PSGI (3) 2015-04-19

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.