PET::Session

sub new

Create instance.  Must be subclassable.

sub init

Init is called from new.  Some implementations might need some basic init-phase stuff.

sub start

This method is called at each page.  It creates a cookie if there is none, if there is one, it fetches and returns it.

sub access

Signal access to session.  This (by default empty) method can be used to store when the session was last touched.  It is called from “finish()”.  $stored [0|1] is passed, which tells if at this run the session has been modified and saved or not.

sub createName

Create the name of the session cookie and returns it.

sub thaw

Thaw the session object from “binary data”.  By default this is the thaw method of the Storable package -- but it can be overriden.  It is recommended but not mandatory for implementing classes to use this method.

Gets binary data, returns hashref.

sub freeze

Freeze hashref to binary data.  See also thaw.

sub store

Serialize and save session data.  Gets SESID and SESSION from $self, and stores them.

Invalidate cookie by deleting it from disk.  (Should we delete the cookie, too?)

sub invalidate

sub finish

sub load

sub get

sub set

sub sessionChanged

Set or get value of “SESSION_CHANGED”, which shows if the session should be synced.

sub getSesid

Return SESID.

sub onStart

Get or set SUB that is called on session creation.

If you call onStart with a subref, it will be stored, and later at any time when a session is initialized, that subref is called upon.  This way you can attach actions to session creation -- this actually is a method to set up a callback.

Usually you want to call onStart from you API at INIT time!

sub cleanupOld

Called conditionally from “start” when a (new) cookie is created.  Should erase old sessions from disk.

If you override this method, try to make it FAST.