README
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