Apache-Session  1.94
About: Apache-Session offers a persistence framework for session data (for arbitrary data, in arbitrary backing stores).
  Fossies Dox: Apache-Session-1.94.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

Apache-Session 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 Apache-Session-1.94.tar.gz contents page and use the Fossies standard member browsing features (also with source code highlighting and additionally with optional code folding).
README
---------------------------------------------------------------------------

    24 February 2004                  Jeffrey W. Baker     

---------------------------------------------------------------------------

DESCRIPTION
-----------

This is Apache::Session 1.93

These modules provide persistent storage for arbitrary data, in arbitrary
backing stores.  The details of interacting with the backing store are
abstracted to make all backing stores behave alike.  The programmer simply
interacts with a tied hash.

COPYRIGHT AND LICENSE
---------------------

Apache::Session is Copyright (c) 1998, 1999, 2000, 2001, 2004  Jeffrey William
Baker .  Distribute under the same terms as Perl itself.

Apache::Session is Copyright (c) 2004-2006 Casey West, .
Disribute under the same terms as Perl itself.

Apache::Session is Copyright (c) 2007-2014 Alexandr Ciornii.
Disribute under the same terms as Perl itself.

PREREQUISITES
-------------

Required for testing: Test::More, Test::Deep, Test::Exception, File::Temp
Required for work: Storable, constant

Most of Apache::Session's functions require Digest::MD5.

If you wish to use the DBI backing stores, you need the latest version of DBI
and the driver for your database.  Currently MySQL, Postgres, and Oracle are
supported.

INSTALLATION
------------
Auto
Use CPAN's or CPANPLUS's shell.

Manual:


tar -xvzf Apache-Session-1.91.tar.gz
cd Apache-Session-1.91
perl Makefile.PL
make
make test
make install

Substitute "nmake"/"dmake" for "make" above if you are using Windows.

EXAMPLE
-------

See eg/example.perl.  This program is intended to be run under mod_perl.

AUTHORS
-------

Jeffrey Baker  is the author of 
Apache::Session.

Tatsuhiko Miyagawa  is the author of 
Generate::ModUniqueID and Generate::ModUsertrack

Erik Rantapaa  found errors in both Lock::File
and Store::File

Bart Schaefer  notified me of a bug in 
Lock::File.

Chris Winters  contributed the Sybase code.

Michael Schout  fixed a commit policy bug in 1.51.

Andreas J. Koenig  contributed valuable CPAN
advice and also Apache::Session::Tree and Apache::Session::Counted.

Gerald Richter  had the idea for a tied hash interface
and provided the initial code for it.  He also uses Apache::Session in
his Embperl module and is the author of Apache::Session::Embperl

Jochen Wiedmann  contributed patches for bugs and
improved performance.

Steve Shreeve  squashed a bug in 0.99.0 whereby
a cleared hash or deleted key failed to set the modified bit.

Peter Kaas  sent quite a bit of feedback
with ideas for interface improvements.

Randy Harmon  contributed the original
storage-independent object interface with input from:

  Bavo De Ridder 
  Jules Bean 
  Lincoln Stein 
  
Scott McWhirter  contributed verbose error messages for
file locking.

Corris Randall  gave us the option to use any table name in
the MySQL store.

Oliver Maul  updated the Sybase modules

Innumerable users sent a patch for the reversed file age test in the file
locking module.

Mike Langen  contributed Informix modules.

FURTHER INFORMATION:
--------------------

Apache   by Apache Group    comp.infosystems.www.servers.unix
                            http://www.apache.org/
                            
mod_perl by Doug MacEachern modperl@apache.org
                            http://perl.apache.org/