<html>
<head>
<link rel="stylesheet" type="text/css" href="dox.css" />
<title>libapreq2-2.16: Main Page</title>
</head>
<body>
<div id="page-header">
<p class="menu">
<a href="http://www.apache.org/">Apache Software Foundation</a> > <a href="http://httpd.apache.org">HTTP Server Project</a> >
<a href="http://httpd.apache.org/apreq/">Request Library Subproject</a></p>
<p class="apache">Apache HTTP Server Request Library</p>
<img alt="" src="feather.gif" /></div>
<!-- Generated by Doxygen 1.8.20 -->
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',false,false,'search.php','Search');
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<div class="PageDoc"><div class="header">
<div class="headertitle">
<div class="title">libapreq2 Documentation</div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Project Website: <a href="http://httpd.apache.org/apreq/">http://httpd.apache.org/apreq/</a></p>
<pre class="fragment">
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.
</pre> </div></div><!-- PageDoc -->
</div><!-- contents -->
<div id="footer">
<p class="apache">
Copyright © 2003-2006 <a href="http://www.apache.org">The Apache Software Foundation</a>.<br/>
See <a href="apreq_license.html">LICENSE</a>.</p>
<p class="menu">
<span style="color:#aaa">page generated by <a href="http://www.doxygen.org/"><code>doxygen</code></a>
version 1.8.20 on Wed Mar 10 2021</span>
</p>
</div>
</body>
</html>