libapreq - Generic Apache Request Library http://httpd.apache.org/apreq/ This package contains modules for manipulating client request data via the Apache API with Perl and C. Functionality includes: - parsing of application/x-www-form-urlencoded data - parsing of multipart/form-data - parsing of HTTP Cookies See libapreq.pod for the C API documentation and eg/c/ for examples. The Perl modules are simply a thin xs layer on top of libapreq, making them a lighter and faster alternative to CGI.pm and CGI::Cookie. See the Apache::Request and Apache::Cookie documentation for more details and eg/perl/ for examples. The Perl interface was designed by Lincoln Stein (lstein@cshl.org), originally implemented as a pure Perl Apache::Request module. The C implementation has a similar look-and-feel, including structures modeled from Lincoln's Perl design. IMPORTANT NOTE: To install the Perl modules, your mod_perl installation MUST includes support for Apache::Table. This means that mod_perl should be built using the EVERYTHING=1, or at minimum PERL_TABLE_API=1. If you see errors like this (during compilation of libapreq) Error: 'Apache::Table' not in typemap in Request.xs, your mod_perl must be rebuilt to include Apache::Table support. The Perl API includes a test suite based on Apache::Test. Type "make test" to run the tests, and be sure Apache::Test is installed prior to running "perl Makefile.PL". IMPORTANT NOTE: The test suite in libapreq-1.1 was based on Apache::test, which is now in the process of being phased out of mod_perl-1.X. libapreq's new tests require Apache::Test version 1.03 or greater. Please read the INSTALL file for more details. Portions of the C code are based on examples from: Writing Apache Modules with Perl and C, Lincoln Stein & Doug MacEachern, O'Reilly & Associates, Sebastapol, CA, 1998, ISBN 1-56592-567-X. http://www.modperl.com/ Development of this package, version 0.32 was sponsored by: Covalent Technologies Inc. http://www.covalent.net/ Development of this package, versions 0.01-0.31 was sponsored by: Critical Path Inc. http://www.cp.net/ Support for the Perl interface is available from: modperl@apache.org Support for the C interface is available from: apreq-dev@httpd.apache.org