mod_perl  2.0.12
About: mod_perl is an Apache/Perl module that embeds a perl interpreter in the 2.x.x branch of the Apache HTTPD Server.
  Fossies Dox: mod_perl-2.0.12.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

mod_perl Documentation

Some Fossies usage hints in advance:

  1. To see the Doxygen generated documentation please click on one of the items in the steelblue colored "quick index" bar above or use the side panel at the left which displays a hierarchical tree-like index structure and is adjustable in width.
  2. If you want to search for something by keyword rather than browse for it you can use the client side search facility (using Javascript and DHTML) that provides live searching, i.e. the search results are presented and adapted as you type in the Search input field at the top right.
  3. Doxygen doesn't incorporate all member files but just a definable subset (basically the main project source code files that are written in a supported language). So to search and browse all member files you may visit the Fossies mod_perl-2.0.12.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
This is mod_perl version 2.0

*** Prerequisites ***

  Dynamic mod_perl (DSO):    Apache 2.0.47 - 2.4.51.
  Static mod_perl:           Apache 2.0.51 - 2.4.51.

  Newer Apache versions may work with this version of mod_perl.  If
  not, the svn version likely will, which can be obtained from:

  Any stable version of Perl currently in support by the Perl community,
  as described in recent Perl distributions' "perlpolicy.pod" document.

  Newer Perl versions may work with this version of mod_perl.  If not,
  the svn version likely will (see above).

  Many older Perl versions also work with this version of mod_perl:
  Perls back to version 5.8.2 (and possibly earlier in some build
  configurations) are currently believed to work, but this is not
  guaranteed to be the case, either now or in the future.

*** Status ***

mod_perl is currently considered stable.

The following test failures are known (see CPAN RT #118919):

  t/filter/in_bbs_inject_header.t (Fails tests 22, 26 and 30)

There is currently a known test failure on Windows when using Perls built
with the PERL_IMPLICIT_SYS build option enabled (which it is by default):

  t/modperl/env.t (Fails many tests)

Various other tests are also known to fail in certain configurations on
Windows, including but not limited to:

  t/modperl/setupenv.t (Fails tests 8, 22, 29, 36, 50 and 57)
  t/preconnection/note.t (Fails test 1)

*** Documentation ***

Documentation can be found in the docs/ directory. Currently they
don't get installed on 'make install'. Certain API documentation can
be found in docs/api/.  The online version is at

*** Todo ***

mod_perl-2.0 is not 100% feature complete with the 1.xx version.
See the files in the todo/ directory for what remains to be done. Some
of those features will be implemented after 2.0 is released. The goal
is to empty the file todo/release and document/test/verify the API
that's going to be supported by 2.0. More API will be supported post
2.0 release.

*** Support ***

For comments, questions, bug-reports, etc., join the mod_perl users
list by sending mail to

Bugs can also be reported at:
which can be accessed from the "Issues" link in the left-hand menu on
the page, .
(Note: You will need to log in to in order to get
the "Report a new bug" button on the bug tracker page.)

When reporting bugs please follow the instructions at:

For announcements join the mod_perl announce list by sending mail to

*** Developers ***

Development discussion takes place on dev (at)

*** Authors ***

mod_perl-2.0 was designed and written by Doug MacEachern, with
contributions from many others (see Changes files).