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