This method returns a hash tied to the Apache::Session class.
This method deletes the existing session from persistent storage. If you are using the built-in cookie mechanism, it also deletes the cookie in the browser.
This module accepts quite a number of parameters, most of which are simply passed through to Apache::Session::Wrapper. For this reason, you are advised to familiarize yourself with the Apache::Session::Wrapper documentation before attempting to configure this module.
If you are creating your own Interp/ApacheHandler/CGIHandler object in a script or module, you should pass this object the parameters intended for Apache::Session::Wrapper, prefixed with session_. So to set the class parameter for Apache::Session::Wrapper, you pass in a session_class parameter.
A few examples:
When running under ApacheHandler or CGIHandler, this module takes care of passing the header_object and param_object parameters to Apache::Session::Wrapper. These will be the Apache::Request or CGI.pm objects, as applicable.
o class becomes session_class / MasonSessionClass o always_write becomes session_always_write / MasonSessionAlwaysWrite
The cookie_name parameter defaults to MasonX-Request-WithApacheSession-cookie when you use this module, instead of Apache-Session-Wrapper-cookie.
Finally, for backwards compatiblity, this module accepts a session_args_param parameter, which corresponds to the param_name parameter for Apache::Session::Wrapper.
As can be seen by the number of parameters above, Apache::Session has <B>wayB> too many possibilities for me to test all of them. This means there are almost certainly bugs.
Bug reports and requests for help should be sent to the mason-users list. See http://www.masonhq.com/resources/mailing_lists.html for more details.
Dave Rolsky, <firstname.lastname@example.org>
Brad Lhotsky, <email@example.com>
|perl v5.20.3||MASONX::REQUEST::WITHAPACHESESSION (3)||2016-04-03|