File: README

package info (click to toggle)
libapache-request-perl 1.1-0.1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 1,312 kB
  • ctags: 184
  • sloc: sh: 6,975; ansic: 1,141; perl: 796; makefile: 55
file content (56 lines) | stat: -rw-r--r-- 2,027 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
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 interface also includes experimental support for Perl+sfio builds:

        % perl Makefile.PL DEFINE=-DSFIO
        % make
        % make install

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