9.1. The Apache Request Object

The Apache request object implements a huge number of methods. To help you find the method you're looking for, we've broken them down into eight broad categories:

Client request methods

Methods that have to do with retrieving information about the current request, such as fetching the requested URI, learning the request document's filename, or reading incoming HTTP headers.

Server response methods

Methods that are concerned with setting outgoing information, such as setting outgoing headers and controlling the document language and compression.

Sending data to the client

Methods for sending document content data to the client.

Server core functions

Methods that control key aspects of transaction processing but are not directly related to processing browser data input or output. For example, the subrequest API is covered in this section.

Server configuration methods

Methods for retrieving configuration information about the server.


Methods for logging error messages and warnings to the server error log.

Access control methods

Methods for controlling access to restricted documents and for authenticating remote users.

mod_perl-specific methods

Methods that use special features of mod_perl which have no counterpart in the C API. They include such things as the gensym() method for generating anonymous filehandles and set_handlers() for altering the list of subroutines that will handle the current request.

Should you wish to subclass ...

Get Writing Apache Modules with Perl and C now with the O’Reilly learning platform.

O’Reilly members experience live online training, plus books, videos, and digital content from nearly 200 publishers.