WIKINDX API 6.9.1

SESSIONHANDLERS.php

WIKINDX : Bibliographic Management system.

Tags
see
https://wikindx.sourceforge.io/

The WIKINDX SourceForge project

author

The WIKINDX Team

license

https://www.isc.org/licenses/ ISC License

Table of Contents

Functions

wkx_session_set_db_handler()  : mixed
Set a db handler for session storage in session table
wkx_session_set_file_handler()  : mixed
Set the default file handler for session storage
wkx_session_open()  : bool
The open callback works like a constructor in classes and is executed when the session is being opened.
wkx_session_close()  : bool
The close callback works like a destructor in classes and is executed after the session write callback has been called.
wkx_session_read()  : string
The read callback must always return a session encoded (serialized) string, or an empty string if there is no data to read.
wkx_session_write()  : bool
The write callback is called when the session needs to be saved and closed.
wkx_session_destroy()  : bool
This callback is executed when a session is destroyed with session_destroy() or with session_regenerate_id() with the destroy parameter set to true.
wkx_session_gc()  : bool
The garbage collector callback is invoked internally by PHP periodically in order to purge old session data.

Functions

wkx_session_set_file_handler()

Set the default file handler for session storage

wkx_session_set_file_handler() : mixed

wkx_session_open()

The open callback works like a constructor in classes and is executed when the session is being opened.

wkx_session_open(string $savePath, string $sessionName) : bool

It is the first callback function executed when the session is started automatically or manually with session_start(). Return value is true for success, false for failure.

Parameters
$savePath : string
$sessionName : string
Return values
bool

wkx_session_close()

The close callback works like a destructor in classes and is executed after the session write callback has been called.

wkx_session_close() : bool

It is also invoked when session_write_close() is called. Return value should be true for success, false for failure.

Return values
bool

wkx_session_read()

The read callback must always return a session encoded (serialized) string, or an empty string if there is no data to read.

wkx_session_read(string $sessionId) : string

This callback is called internally by PHP when the session starts or when session_start() is called. Before this callback is invoked PHP will invoke the open callback.

The value this callback returns must be in exactly the same serialized format that was originally passed for storage to the write callback. The value returned will be unserialized automatically by PHP and used to populate the $_SESSION superglobal. While the data looks similar to serialize() please note it is a different format which is specified in the session.serialize_handler ini setting.

Parameters
$sessionId : string
Return values
string

wkx_session_write()

The write callback is called when the session needs to be saved and closed.

wkx_session_write(string $sessionId, string $sessionData) : bool

This callback receives the current session ID a serialized version the $_SESSION superglobal. The serialization method used internally by PHP is specified in the session.serialize_handler ini setting.

The serialized session data passed to this callback should be stored against the passed session ID. When retrieving this data, the read callback must return the exact value that was originally passed to the write callback.

This callback is invoked when PHP shuts down or explicitly when session_write_close() is called. Note that after executing this function PHP will internally execute the close callback.

Parameters
$sessionId : string
$sessionData : string
Return values
bool

wkx_session_destroy()

This callback is executed when a session is destroyed with session_destroy() or with session_regenerate_id() with the destroy parameter set to true.

wkx_session_destroy(string $sessionId) : bool

Return value should be true for success, false for failure.

Parameters
$sessionId : string
Return values
bool

wkx_session_gc()

The garbage collector callback is invoked internally by PHP periodically in order to purge old session data.

wkx_session_gc(int $maxSessionLifetime) : bool

The frequency is controlled by WIKINDX_SESSION_GC_FREQUENCY. The value of lifetime which is passed to this callback is a fallback set in session.gc_maxlifetime.

The real value of lifetime is:

  • WIKINDX_SESSION_AUTH_MAXLIFETIME for sessions which have been authenticated at least once.
  • WIKINDX_SESSION_AUTH_REMEMBERME_MAXLIFETIME for sessions which have been authenticated at least once with a "Remember Me" flag.
  • WIKINDX_SESSION_NOTAUTH_MAXLIFETIME for sessions which have never been authenticated.

Return value should be true for success, false for failure.

Parameters
$maxSessionLifetime : int

(in seconds)

Return values
bool

        
On this page

Search results