Apache::SessionX - An extented persistence framework for session data
----------------------------------------------------------------------
Copyright (c) 1997-2001 Gerald Richter / ecos gmbh
You may distribute under the terms of either the GNU General Public
License or the Artistic License, as specified in the Perl README file.
THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
$Id: README,v 1.2 2001/08/14 04:37:28 richter Exp $
OVERVIEW
========
Apache::SessionX extents Apache::Session. It was initialy written to
use Apache::Session from inside of HTML::Embperl, but is seems to be
usefull outside of Embperl as well, so here is it as standalone module.
Apache::Session is a persistence framework which is particularly useful
for tracking session data between httpd requests. Apache::Session is
designed to work with Apache and mod_perl, but it should work under
CGI and other web servers, and it also works outside of a web server
altogether.
Addtionaly to Apache::Session, Apache::SessionX provides the following
possibilites:
- Configuration: Makefile.PL checks which componemnts are installed
on the system and interactivly builds a set of configuration,
including a default one. This configurations are saved and can
be used by name later on. The default configuration is used, if
no parameters are given to Apache::SessionX. This simplifies
the configuration and usage.
- Lazy operation: Apache::SessionX supports lazy operation, that means
that the actual data access only takes place if the session data is
needed, so you are able to setup the session object, without worrying
about performance in case you don't access the session data.
- Specifing the ID: Apache::SessionX can use a given ID instead of
creating it's own one. You can also give an string which is used to
generate the ID
- Genrate unique ID: Apache::SessionX is able to save the session with
an new ID every time data is modified. This make it possible to keep
an history.
- Addtionaly methods are provided to get the ID, the inital ID, the
modified status and to close a session, without destroying the
session object itself.
DOCUMENTATION
=============
After Installation the documentaion could be viewed via
perldoc Apache::SessionX
You should addtionaly read the
perldoc Apache::SessionX
perldoc Apache::SessionX::Generate::MD5
perldoc Apache::Session::Store::*
perldoc Apache::Session::Lock::*
perldoc Apache::Session::Serialize::*
INSTALLATION
============
perl Makefile.PL
make
make test
make install
Makefile.PL will ask you what configuration you want to use and saves
them for later use with the config parameter. This configuration are
tested when you run make test, so it's really a good idea to run
make test, to make sure everything works as expected. Even better is
to run make test as the user, that your webserver is running as, so
you are able to detected permission problems early.
SUPPORT
=======
You can get support for this module via the mod_perl or Embperl
mailing list. Please use the lists for any questions and don't
contact me directly. Details about the list can be found at
http://perl.apache.org/
AUTHOR
======
G. Richter (richter@dev.ecos.de)