Home / Documentation / 2.0 / | ||||
mod_perl 2.0 API | ||||
|
||
The Apache::, APR:: and ModPerl:: namespaces APIs for mod_perl 2.0
Apache2::CmdParms
provides the Perl API for Apache command
parameters object.Apache2::Command
provides the Perl API for accessing Apache module
command informationApache2::RequestRec
provides the Perl API for Apache connection
record object.Apache2::ConnectionUtil
provides the
Apache connection record object
utilities API.Apache
features.Apache2::Directive
provides the Perl API for manipulating the Apache
configuration treeApache2::Filter
provides Perl API for Apache 2.0 filtering
framework.Apache2::FilterRec
provides an access to the filter record
structure.Apache2::HookRun
exposes parts of the Apache HTTP protocol
implementation, responsible for invoking callbacks for each HTTP Request cycle phase.Apache2::Log
provides the Perl API for Apache logging methods.Apache2::MPM
provides the Perl API for accessing Apache MPM
information.Apache2::Module
provides the Perl API for creating and working with
Apache modules<Perl>
...</Perl>
sections, it is possible
to configure your server entirely in Perl.Apache2::Process
provides the API for the Apache process object,
which you can retrieve with
$s->process
:Apache2::RequestIO
provides the API to perform IO on the Apache request object.Apache2::RequestRec
provides the Perl API for Apache request_rec
object.Apache2::RequestUtil
provides the Apache request object utilities API.Apache2::Response
provides the Apache request object utilities API for dealing
with HTTP response generation process.Apache2::ServerRec
provides the Perl API for Apache server_rec
object.Apache2::ServerUtil
provides the Apache server object utilities API.Apache2::SubProcess
provides the Perl API for running and
communicating with processes spawned from mod_perl handlers.Apache2::SubRequest
contains API for creating and running of Apache
sub-requests.APR::URI
provides a generic API to dissect, adjust and put
together any given URI string, Apache2::URI
provides an API specific
to Apache, by taking the information directly from the $r
object. Therefore when manipulating the URI of the current HTTP
request usually methods from both classes are used.APR::Base64
provides the access to APR's base64 encoding and
decoding API.APR::Brigade
allows you to create, manipulate and delete APR bucket
brigades.APR::Bucket
allows you to create, manipulate and delete APR
buckets.APR::BucketAlloc
is used for bucket allocation.APR::BucketType
allows you to query bucket object type properties.APR
features.APR::Socket
provides the Perl interface to APR date manipulating
functions.APR::Error
handles APR/Apache/mod_perl exceptions for you, while
leaving you in control.stat()
call, but you will want to use this module's API to query an
already stat()'ed
filehandle to avoid an extra system call or to
query attributes specific to APR file handles.APR::IpSubnet
object represents a range of IP addresses
(IPv4/IPv6). A socket connection can be matched against this range to
test whether the IP it's coming from is inside or outside of this
range.APR::OS
provides the Perl interface to platform-specific APR API.APR::PerlIO
implements a Perl IO layer using APR's file
manipulation API internally.APR::Pool
provides an access to APR pools, which are used for an
easy memory management.APR::SockAddr
provides an access to a socket address structure
fields.APR::Socket
provides the Perl interface to APR sockets.APR::String
provides strings manipulation API.APR::Table
allows its users to manipulate opaque string-content
tables.APR::ThreadMutex
interfaces APR thread mutexes.APR::ThreadRWLock
interfaces APR thread read/write locks.APR::URI
allows you to parse URI strings, manipulate each of the
URI elements and deparse them back into URIs.APR::UUID
is used to get and manipulate random UUIDs.ModPerl::Global
provides an API to manipulate special perl
lists. At the moment only the END
blocks list is supported.ModPerl::MethodLookup
provides the Perl API for finding
module names which contain methods in question and other helper
functions, to find out out what methods defined by some module, what
methods can be called on a given object, etc.ModPerl::MM
is a "subclass" of ExtUtils::MakeMaker
for mod_perl
2.0, to a degree of sub-classability of ExtUtils::MakeMaker
.ModPerl::PerlRunPrefork
should be used by those who run only under prefork MPM.http://example.com/perl/test.pl
will be
compiled as the body of a Perl subroutine and executed. Each child
process will compile the subroutine once and store it in memory. It
will recompile it whenever the file (e.g. test.pl in our example)
is updated on disk. Think of it as an object oriented server with
each script implementing a class loaded at runtime.ModPerl::RegistryBB
is similar to ModPerl::Registry
, but does
the bare minimum (mnemonic: BB = Bare Bones) to compile a script file
once and run it many times, in order to get the maximum
performance. Whereas ModPerl::Registry
does various checks,
which add a slight overhead to response times.ModPerl::RegistryCooker
is used to create flexible and overridable
registry modules which emulate mod_cgi for Perl scripts. The concepts
are discussed in the manpage of the following modules:
ModPerl::Registry
, ModPerl::Registry
and
ModPerl::RegistryBB
.ModPerl::RegistryCooker
, at server startup. The
script's handler routine is compiled by the parent server, of which
children get a copy and thus saves some memory by initially sharing
the compiled copy with the parent and saving the overhead of script's
compilation on the first request in every httpd instance.ModPerl::Util
provides mod_perl utilities API.Apache2::compat
provides mod_perl 1.0 compatibility layer and can be
used to smooth the transition process to mod_perl 2.0.Apache2::porting
helps to port mod_perl 1.0 code to run under
mod_perl 2.0. It doesn't provide any back-compatibility functionality,
however it knows to trap methods calls that are no longer in the
mod_perl 2.0 API and tell what should be used instead if at all. If
you attempts to use mod_perl 2.0 methods without first loading the
modules that contain them, it will tell you which modules you need to
load. Finally if your code tries to load modules that no longer exist
in mod_perl 2.0 it'll also tell you what are the modules that should
be used instead.Apache2::Reload
reloads modules that change on the disk.Apache2::Resource
uses the BSD::Resource
module, which uses the C
function setrlimit
to set limits on system resources such as memory
and cpu usage.Apache2::Status
module provides some information
about the status of the Perl interpreter embedded in the server.ModPerl::BuildMM
is a "subclass" of ModPerl::MM
used for
building mod_perl 2.0. Refer to
ModPerl::MM
manpage.See
search.cpan.org
or perldoc.perl.org for
documentation of the 3rd party Apache::
modules.
|