NAME

Net::FastCGI - FastCGI Toolkit

DESCRIPTION

This distribution aims to provide a complete API for working with the FastCGI protocol.

The primary goal is to provide a function oriented and object oriented API which are not tied to a specific I/O model or framework.

Secondary goal is to provide higher level tools/API which can be used for debugging and interoperability testing.

PROGRESS

The function oriented API is considered feature complete. Net::FastCGI::Protocol provides functions to build and parse all FastCGI v1.0 messages, also provided is a few convenient higher level functions such as build_begin_request(), build_end_request(), parse_record() and dump_record().

Work has begun on object oriented implementation and a simple blocking I/O class which is intended for testing and debugging.

PACKAGES

Net::FastCGI::Constant

FastCGI protocol constants.

Net::FastCGI::IO

Provides functions to read and write FastCGI messages.

Net::FastCGI::Protocol

Provides functions to build and parse FastCGI messages.

ENVIRONMENT

Environment variable NET_FASTCGI_PP can be set to a true value before loading this package to disable usage of XS implementation.

PREREQUISITES

Run-Time

perl 5.6 or greater.
Carp, core module.
Exporter, core module.

Build-Time

In addition to Run-Time:

Test::More 0.47 or greater, core module since 5.6.2.
Test::Exception.
Test::HexString.

SEE ALSO

Community

Official FastCGI site

http://www.fastcgi.com/

Standards

FastCGI Specification Version 1.0

http://www.fastcgi.com/devkit/doc/fcgi-spec.html

RFC 3875 - The Common Gateway Interface (CGI) Version 1.1

http://tools.ietf.org/html/rfc3875

White papers

FastCGI: A High-Performance Web Server Interface

http://www.fastcgi.com/devkit/doc/fastcgi-whitepaper/fastcgi.htm

FastCGI - The Forgotten Treasure

http://cryp.to/publications/fastcgi/

Perl implementations

AnyEvent::FCGI

Application server implementation, built on top of AnyEvent. Supports Responder role. Capable of multiplexing.

FCGI

Application server implementation, built on top of libfcgi (reference implementation). Supports all FastCGI roles. Responds to management records. Processes requests synchronously.

FCGI::Async

Application server implementation, built on top of IO::Async. Supports Responder role. Responds to management records. Capable of multiplexing.

FCGI::Client

Client (Web server) implementation. Supports Responder role.

FCGI::EV

Application server implementation, built on top of EV. Supports Responder role.

Mojo::Server::FastCGI

Application server implementation. Supports Responder role. Processes requests synchronously.

POE::Component::FastCGI

Application server implementation, built on top of POE. Supports Responder role. Capable of multiplexing.

SUPPORT

Please report any bugs or feature requests to bug-net-fastcgi@rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-FastCGI

AUTHOR

Christian Hansen chansen@cpan.org

COPYRIGHT

Copyright 2008-2010 by Christian Hansen.

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