| 1 |
libapreq - Generic Apache Request Library |
| 2 |
http://httpd.apache.org/apreq/ |
| 3 |
|
| 4 |
This package contains modules for manipulating client request data via |
| 5 |
the Apache API with Perl and C. Functionality includes: |
| 6 |
|
| 7 |
- parsing of application/x-www-form-urlencoded data |
| 8 |
- parsing of multipart/form-data |
| 9 |
- parsing of HTTP Cookies |
| 10 |
|
| 11 |
See libapreq.pod for the C API documentation and |
| 12 |
eg/c/ for examples. |
| 13 |
|
| 14 |
The Perl modules are simply a thin xs layer on top of libapreq, |
| 15 |
making them a lighter and faster alternative to CGI.pm and |
| 16 |
CGI::Cookie. See the Apache::Request and Apache::Cookie documentation |
| 17 |
for more details and eg/perl/ for examples. |
| 18 |
|
| 19 |
The Perl interface was designed by Lincoln Stein (lstein@cshl.org), |
| 20 |
originally implemented as a pure Perl Apache::Request module. |
| 21 |
The C implementation has a similar look-and-feel, including structures |
| 22 |
modeled from Lincoln's Perl design. |
| 23 |
|
| 24 |
IMPORTANT NOTE: To install the Perl modules, your mod_perl installation |
| 25 |
MUST includes support for Apache::Table. This means that mod_perl should |
| 26 |
be built using the EVERYTHING=1, or at minimum PERL_TABLE_API=1. If you |
| 27 |
see errors like this (during compilation of libapreq) |
| 28 |
|
| 29 |
Error: 'Apache::Table' not in typemap in Request.xs, |
| 30 |
|
| 31 |
your mod_perl must be rebuilt to include Apache::Table support. |
| 32 |
|
| 33 |
The Perl API includes a test suite based on Apache::Test. |
| 34 |
Type "make test" to run the tests, and be sure Apache::Test |
| 35 |
is installed prior to running "perl Makefile.PL". |
| 36 |
|
| 37 |
IMPORTANT NOTE: The test suite in libapreq-1.1 was based |
| 38 |
on Apache::test, which is now in the process of being phased |
| 39 |
out of mod_perl-1.X. libapreq's new tests require Apache::Test |
| 40 |
version 1.03 or greater. Please read the INSTALL file for more details. |
| 41 |
|
| 42 |
Portions of the C code are based on examples from: |
| 43 |
Writing Apache Modules with Perl and C, |
| 44 |
Lincoln Stein & Doug MacEachern, |
| 45 |
O'Reilly & Associates, Sebastapol, CA, 1998, |
| 46 |
ISBN 1-56592-567-X. |
| 47 |
http://www.modperl.com/ |
| 48 |
|
| 49 |
Development of this package, version 0.32 was sponsored by: |
| 50 |
Covalent Technologies Inc. http://www.covalent.net/ |
| 51 |
|
| 52 |
Development of this package, versions 0.01-0.31 was sponsored by: |
| 53 |
Critical Path Inc. http://www.cp.net/ |
| 54 |
|
| 55 |
Support for the Perl interface is available from: |
| 56 |
modperl@apache.org |
| 57 |
|
| 58 |
Support for the C interface is available from: |
| 59 |
apreq-dev@httpd.apache.org |
Parent Directory
| 
Revision Log