I'd like to announce that the first public release of CGI::Application::Session is now available on CPAN. This module seamlessly integrates CGI::Session support into CGI::Application. Since this is the first public release, the code is still considered alpha, and the functionality is subject to change (though I will try my best to avoid any interface changes).
The module is very simple to use. Simply add a 'use CGI::Application::Session' at the top of your CGI::Application module and you now have access to three new methods (session, session_config, session_cookie). Configuration is not required as the module will choose some sane defaults.
Here is the simplest example of how to use this module:
use base qw(CGI::Application); use CGI::Application::Session;
sub my_runmode {
my $self = shift; # Get the users language from the session
my $language = $self->session->param('language');
...
}That will automatically setup file based sessions using CGI::Session without needing any configuration options. If you want more control over how the session is created read the docs on 'session_config' to see how you can customize the behaviour. Also read the CGI::Session docs for more info on what you can do with the session object.
For those of you who played with the 0.01 release I posted a couple of weeks ago, there is one major change that I made with regards to the session_config method. It is more configurable now, but alas it is not backwards compatible with the 0.01 release, so please read the docs and/or Changes file for the updates.
Also, the module depends on the latest version (3.21) of CGI::Application. It uses the new header_add method to automatically add a cookie into the outgoing headers. One caveat with this is that you shouldn't use the header_props method in your code anymore, as it will clobber the cookie (or you can turn off cookie support and manage the cookies yourself).
Please let me know what you think of this module. I would appreciate any constructive critisism on the code and the interface.
Cheers,
Cees
--------------------------------------------------------------------- Web Archive: http://www.mail-archive.com/[EMAIL PROTECTED]/ http://marc.theaimsgroup.com/?l=cgiapp&r=1&w=2 To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
