1NAME 2 Net::FastCGI - FastCGI Toolkit 3 4DESCRIPTION 5 This distribution aims to provide a complete API for working with the 6 FastCGI protocol. 7 8 The primary goal is to provide a function oriented and object oriented 9 API which are not tied to a specific I/O model or framework. 10 11 Secondary goal is to provide higher level tools/API which can be used 12 for debugging and interoperability testing. 13 14PROGRESS 15 The function oriented API is considered feature complete. 16 Net::FastCGI::Protocol provides functions to build and parse all FastCGI 17 v1.0 messages, also provided is a few convenient higher level functions 18 such as "build_begin_request()", "build_end_request()", "parse_record()" 19 and "dump_record()". 20 21 Work has begun on object oriented implementation and a simple blocking 22 I/O class which is intended for testing and debugging. 23 24PACKAGES 25 Net::FastCGI::Constant 26 FastCGI protocol constants. 27 28 Net::FastCGI::IO 29 Provides functions to read and write FastCGI messages. 30 31 Net::FastCGI::Protocol 32 Provides functions to build and parse FastCGI messages. 33 34ENVIRONMENT 35 Environment variable "NET_FASTCGI_PP" can be set to a true value before 36 loading this package to disable usage of XS implementation. 37 38PREREQUISITES 39 Run-Time 40 perl 5.6 or greater. 41 Carp, core module. 42 Exporter, core module. 43 44 Build-Time 45 In addition to Run-Time: 46 47 Test::More 0.47 or greater, core module since 5.6.2. 48 Test::Exception. 49 Test::HexString. 50 51SEE ALSO 52 Community 53 Official FastCGI site 54 <http://www.fastcgi.com/> 55 56 Standards 57 FastCGI Specification Version 1.0 58 <http://www.fastcgi.com/devkit/doc/fcgi-spec.html> 59 60 RFC 3875 - The Common Gateway Interface (CGI) Version 1.1 61 <http://tools.ietf.org/html/rfc3875> 62 63 White papers 64 FastCGI: A High-Performance Web Server Interface 65 <http://www.fastcgi.com/devkit/doc/fastcgi-whitepaper/fastcgi.htm> 66 67 FastCGI - The Forgotten Treasure 68 <http://cryp.to/publications/fastcgi/> 69 70 Perl implementations 71 AnyEvent::FCGI 72 Application server implementation, built on top of AnyEvent. 73 Supports Responder role. Capable of multiplexing. 74 75 FCGI 76 Application server implementation, built on top of "libfcgi" 77 (reference implementation). Supports all FastCGI roles. Responds to 78 management records. Processes requests synchronously. 79 80 FCGI::Async 81 Application server implementation, built on top of IO::Async. 82 Supports Responder role. Responds to management records. Capable of 83 multiplexing. 84 85 FCGI::Client 86 Client (Web server) implementation. Supports Responder role. 87 88 FCGI::EV 89 Application server implementation, built on top of EV. Supports 90 Responder role. 91 92 Mojo::Server::FastCGI 93 Application server implementation. Supports Responder role. 94 Processes requests synchronously. 95 96 POE::Component::FastCGI 97 Application server implementation, built on top of POE. Supports 98 Responder role. Capable of multiplexing. 99 100SUPPORT 101 Please report any bugs or feature requests to 102 "bug-net-fastcgi@rt.cpan.org", or through the web interface at 103 <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-FastCGI> 104 105AUTHOR 106 Christian Hansen "chansen@cpan.org" 107 108COPYRIGHT 109 Copyright 2008-2010 by Christian Hansen. 110 111 This library is free software; you can redistribute it and/or modify it 112 under the same terms as Perl itself. 113 114