core\session\database Class Reference

Database based session handler. More...

Inheritance diagram for core\session\database:

Public Member Functions
	__construct ()
	Create new instance of handler.
	abort ()
	Release lock on the session without writing it.
	handler_close ()
	Close session handler.
	handler_destroy ($sid)
	Destroy session handler.
	handler_gc ($ignored_maxlifetime)
	GC session handler.
	handler_open ($save_path, $session_name)
	Open session handler.
	handler_read ($sid)
	Read session handler.
	handler_write ($sid, $session_data)
	Write session handler.
	init ()
	Init session handler.
	kill_all_sessions ()
	Kill all active sessions, the core sessions table is purged afterwards.
	kill_session ($sid)
	Kill one session, the session record is removed afterwards.
	requires_write_lock ()
	Has this session been opened with a writelock?
	session_exists ($sid)
	Check the backend contains data for this session id.
	set_requires_write_lock ($requireswritelock)
	This is called after init() and before start() to indicate whether the session opened should be writable or not.
	start ()
	Start the session.
	write_close ()
	Write the session and release lock.

Protected Attributes
int	$acquiretimeout = 120
	$acquiretimeout how long to wait for session lock
moodle_database	$database = null
	$database session database
bool	$failed = false
	$failed session read/init failed, do not write back to DB
string	$lasthash = null
	$lasthash hash of the session data content
stdClass	$recordid = null
	$record session record
boolean	$requireswritelock = false
	$requireswritelock does the session need and/or have a lock?

Detailed Description

Database based session handler.

Copyright

2013 Petr Skoda

License

http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

abort()

core\session\handler::abort ( )

inherited

Release lock on the session without writing it.

May not be possible in older versions of PHP. If so, session may be written anyway so that any locks are released.

handler_close()

core\session\database::handler_close

(

)

Close session handler.

{

See also

http://php.net/manual/en/function.session-set-save-handler.php}

Return values

bool

success

handler_destroy()

core\session\database::handler_destroy

(

$sid

)

Destroy session handler.

{

See also

http://php.net/manual/en/function.session-set-save-handler.php}

Parameters

string

$sid

Return values

bool

success

handler_gc()

core\session\database::handler_gc

(

$ignored_maxlifetime

)

GC session handler.

{

See also

http://php.net/manual/en/function.session-set-save-handler.php}

Parameters

int

$ignored_maxlifetime

moodle uses special timeout rules

Return values

bool

success

handler_open()

core\session\database::handler_open	(		$save_path,
			$session_name )

Open session handler.

{

See also

http://php.net/manual/en/function.session-set-save-handler.php}

Parameters

string	$save_path
string	$session_name

Return values

bool

success

handler_read()

core\session\database::handler_read

(

$sid

)

Read session handler.

{

See also

http://php.net/manual/en/function.session-set-save-handler.php}

Parameters

string

$sid

Return values

string

handler_write()

core\session\database::handler_write	(		$sid,
			$session_data )

Write session handler.

{

See also

http://php.net/manual/en/function.session-set-save-handler.php}

NOTE: Do not write to output or throw any exceptions! Hopefully the next page is going to display nice error or it recovers...

Parameters

string	$sid
string	$session_data

Return values

bool

success

init()

core\session\database::init

(

)

Init session handler.

Reimplemented from core\session\handler.

kill_all_sessions()

core\session\database::kill_all_sessions

(

)

Kill all active sessions, the core sessions table is purged afterwards.

Reimplemented from core\session\handler.

kill_session()

core\session\database::kill_session

(

$sid

)

Kill one session, the session record is removed afterwards.

Parameters

string

$sid

Reimplemented from core\session\handler.

requires_write_lock()

core\session\handler::requires_write_lock ( )

inherited

Has this session been opened with a writelock?

Your handler should call this during start() if you support read-only sessions.

Return values

bool	true if session is intended to have a write lock.

session_exists()

core\session\database::session_exists

(

$sid

)

Check the backend contains data for this session id.

Note: this is intended to be called from manager::session_exists() only.

Parameters

string

$sid

Return values

bool	true if session found.

Reimplemented from core\session\handler.

set_requires_write_lock()

core\session\handler::set_requires_write_lock ( $requireswritelock )

inherited

This is called after init() and before start() to indicate whether the session opened should be writable or not.

This is intentionally captured even if your handler doesn't support non-locking sessions, so that behavior (upon session close) matches closely between handlers.

Parameters

bool

$requireswritelock

true if needs to be open for writing

start()

core\session\handler::start ( )

inherited

Start the session.

Return values

bool

success

Reimplemented in core\session\memcached, and core\session\redis.

write_close()

core\session\handler::write_close ( )

inherited

Write the session and release lock.

If the session was not intentionally opened with a write lock, then we will abort the session instead if able.

---

The documentation for this class was generated from the following file:

• lib/classes/session/database.php