NAME

PLP::Backend::Apache - Apache mod_perl interface for PLP

SYNOPSIS

Naturally, you'll need to enable mod_perl:

    apache-modconf apache enable mod_perl

Setup httpd.conf (in new installs just create /etc/apache/conf.d/plp) with:

    <IfModule mod_perl.c>
        <Files *.plp>
            SetHandler perl-script
            PerlHandler PLP::Backend::Apache
            PerlSendHeader On
        </Files>
    </IfModule>

DESCRIPTION

Configuration directives

PLP behaviour can be configured by PerlSetVar rules. These can be added to a .htaccess file or most any scope of server configuration. For example, to disable caching for a specific site:

        <Directory /var/www/somesite/>
                PerlSetVar PLPcache Off
        </Directory>

PLPcache

Sets caching On/Off. When caching, PLP saves your script in memory and doesn't re-read and re-parse it if it hasn't changed. PLP will use more memory, but will also run 50% faster.

On is default, anything that isn't =~ /^off$/i is considered On.

BUGS

With mod_perl2, any new request will change the cwd for all processes. This means that if you're running files from multiple directories, you should not use the current path for it may change at any time.

The bug has been confirmed with at least mod_perl 2.0.2/3/4 on Apache 2.2.3/8. Using this backend on Apache2 is extremely discouraged until this is fixed. Instead, the FastCGI backend is recommended.

Apache1 does not show any problems.

AUTHOR

Mischa POSLAWSKY <perl@shiar.org>

SEE ALSO

PLP, PLP::Backend::FastCGI, mod_perl