The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Apache::Session::File - Store client sessions in your filesystem

SYNOPSIS

use Apache::Session::File

DESCRIPTION

This is a File storage subclass for Apache::Session. Client state is stored in flat files. Try perldoc Session for more info.

INSTALLATION

Getting started

You will need to create a directory for Apache to store the session files. This directory must be writeable by the httpd process.

Environment

You will need to configure your environment to get Session::File to work. You should define the variable SESSION_FILE_DIRECTORY with the name of the directory that you prepared above. The package will croak if you don't define this.

I define this variables in my httpd.conf:

 PerlSetEnv SESSION_FILE_DIRECTORY /tmp/sessions

USAGE

This package complies with the API defined by Apache::Session. For details, please see that package's documentation.

The default for autocommit in Apache::Session::File is 0, which means that you will need to either call $session->store() when you are done or set autocommit to 1 via the open() and new() functions.

NOTES

The session hashes are stored in network order, so you should be able to use this package on an NFS filesystem for a whole server farm.

Performance worsens every time a new sessions is created. The session directory should be cleaned out occasionally. There is a garbage collector at the top of this file which you may want to uncomment and play with.

Let me know if it works.

AUTHORS

Jeffrey Baker <jeff@godzilla.tamu.edu>, author and maintainer.

Redistribute under the Perl Artistic License.