Apache HTTP Server Request Library | |
What is it? | |
----------- | |
httpd-apreq is subproject of the Apache HTTP Server Project | |
whose committers develop and maintain the libapreq C library | |
and its language bindings for Perl (contributions for additional | |
language bindings are most welcome). | |
libapreq is a safe, standards-compliant, high-performance library | |
used for parsing HTTP cookies, query-strings and POST data. The | |
original version (libapreq-1.X) was designed by Lincoln Stein and Doug | |
MacEachern. The perl APIs Apache::Request and Apache::Cookie are the | |
lightweight mod_perl analogs of the CGI and CGI::Cookie perl modules. | |
Version 2 of libapreq is an improved codebase designed around APR | |
and Apache-2's input filter API. The C codebase is separated into | |
two independent components: | |
1) libapreq2, a shared library which is based on | |
libapr and libaprutil. | |
2) A collection of modules: | |
- mod_apreq2, a filter module for the Apache 2.X webserver, | |
- a CGI module included in libapreq2 itself, | |
- a custom module for general applications. | |
Version 2 also includes the perl APIs for libapreq2- Apache2::Request, | |
Apache2::Upload and Apache2::Cookie. The corresponding XS modules | |
are generated by ExtUtils::XSBuilder, which is based on the new build | |
system created specifically for mod_perl2. | |
The Latest Version | |
------------------ | |
Details of the latest version can be found on the libapreq | |
project page at | |
http://httpd.apache.org/apreq | |
Documentation | |
------------- | |
The documentation is in the docs/ directory. It is | |
based on Doxygen, and can be regenerated by typing | |
% make docs | |
in the main directory. | |
Installation | |
------------ | |
For full details please consult the INSTALL file. Briefly, | |
to install just the C API (libapreq2 + environment modules) | |
on a Unix-like system: | |
% ./configure --with-apache2-apxs=/path/to/apache2/bin/apxs | |
% make | |
% make test | |
% make install | |
To build and install the perl API as well, either add | |
the "--enable-perl-glue" configure option, or let Makefile.PL | |
enable it for you: | |
% perl Makefile.PL --with-apache2-apxs=/path/to/apache2/bin/apxs | |
% make | |
% make test | |
% make install | |
Licensing | |
--------- | |
Please see the file called LICENSE. | |
Contacts | |
-------- | |
o Project homepage: | |
http://httpd.apache.org/apreq/ | |
o Mailing Lists: | |
user lists: | |
C/C++ API - modules-dev@httpd.apache.org | |
Perl API - modperl@perl.apache.org | |
Tcl API - XXX | |
Java API - XXX | |
Python API - XXX | |
developer list (bugs, patches, code contributions, etc.): | |
apreq-dev@httpd.apache.org | |
Acknowledgments | |
---------------- | |
We wish to acknowledge the following copyrighted works that | |
make up portions of the Apache software: | |
libapreq2 relies heavily on the use of the GNU auto-tools | |
to provide a build environment. The tests are based on | |
the Apache::Test, Test::Harness and Test::Inline. | |
Doxygen generates the documentation for libapreq2. The perl glue | |
and pods are generated by ExtUtils::XSBuilder. |