NAME
Apache::AxKit::Plugin::BasicSession - AxKit plugin that handles setting / loading of Sessions
SYNOPSIS
AxAddPlugin Apache::AxKit::Plugin::BasicSession
PerlSetVar BasicSessionDataStore DB_File
PerlSetVar BasicSessionArgs "FileName => /tmp/session"DESCRIPTION
Session is an AxKit plugin which automatically creates and manages server-side user sessions. Based on Apache::Session::Flex, this allows you to specify all the parameters normally configurable through ::Flex.
Parameter Reference
BasicSessionDataStore
Sets the backend datastore module. Default: DB_File
BasicSessionLock
Sets the record locking module. Default: Null
BasicSessionGenerate
Sets the session id generation module. Default: MD5
BasicSessionSerialize
Sets the hash serializer module. Default: Storable
BasicSessionArgs
Comma-separated list of name/value pairs. This is used to pass additional parameters to Apache::Session::Flex for the particular modules you select. For instance: if you use MySQL for your DataStore, you need to pass the database connection information. You could pass this by calling:
PerlSetVar BasicSessionArgs "DataSource => dbi:mysql:sessions, \
UserName => session_user, \
Password => session_password"BasicSessionCookie*
These arguments set the parameters your session cookie will be created with. The possible options are "BasicSessionCookiePath", "BasicSessionCookieDomain", "BasicSessionCookieExpires", "BasicSessionCookieSecure". All options take an arbitrary string, except Expires and Secure. BasicSessionCookieSecure takes a boolean (yes or no) while Expires takes a time interval (for more information, please see Apache::Cookie).
AxKit::XSP::Session Support
This plugin was created to complement AxKit::XSP::Session, but can be used without the taglib.
Every session access, the session key "_last_accessed_time" is set to the current date-timestamp. When a new session is created, the session key "_creation_time" is set to the current date-timestamp.
ERRORS
To tell you the truth, I haven't tested this enough to know what happens when it fails. I'll update this if any glaring problems are found.
AUTHOR
Michael A Nachbaur, mike@nachbaur.com
COPYRIGHT
Copyright (c) 2001 Michael A Nachbaur. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
SEE ALSO
AxKit, AxKit::XSP::Session, Apache::Session, Apache::Session::Flex