| 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 |