Reference

Apache::Session::Embperl(3pm)

Apache::Session::Embperl - works with HTML::Embperl An adaptation of Apache::Session to work with HTML::Embperl
Addtional Attributes for TIE
By Specifing this attribute, you tell Apache::Session to not do any access to the object store, until the first read or write access to the tied hash. Otherwise the tie function will make sure the hash exist or creates a new one.
Setting this to one causes Apache::Session to create a new session when the specified session id does not exists. Otherwise it will die.
Specify the class for the object store. (The Apache::Session:: prefix is optional)
Specify the class for the lock manager. (The Apache::Session:: prefix is optional) Example using attrubtes to specfiy store and object classes instead of a derived class:

 use Apache::Session ;

 tie %session, 'Apache::Session', undef,
    { 
    object_store => 'DBIStore',
    lock_manager => 'SysVSemaphoreLocker',
    DataSource => 'dbi:Oracle:db' 
    };

NOTE: Apache::Session will require the nessecary additional perl modules for you.
Addtional Methods
Set the session id for futher accesses.
Get the session id. The difference to using $session{_session_id} is, that in lazy mode, getid will not create a new session id, if it doesn't exists.
Writes any pending data, releases all locks and deletes all data from memory. This class was written by Jeffrey Baker ([email protected]) but it is taken wholesale from a patch that Gerald Richter ([email protected]) sent me against Apache::Session