Moodle PHP Documentation 4.2
Moodle 4.2.8 (Build: 20240610) (2d41ac46f45)
core\session\memcached Class Reference

Memcached based session handler. More...

Inheritance diagram for core\session\memcached:
core\session\handler

Public Member Functions

 __construct ()
 Create new instance of handler.
 
 abort ()
 Release lock on the session without writing it.
 
 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? Your handler should call this during start() if you support read-only sessions.
 
 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.
 

Static Protected Member Functions

static connection_string_to_memcache_servers (string $str)
 Convert a connection string to an array of servers.
 

Protected Attributes

int $acquiretimeout = 120
 $acquiretimeout how long to wait for session lock
 
int $lockexpire = 7200
 $lockexpire how long to wait before expiring the lock so that other requests may continue execution, ignored if PECL memcached is below version 2.2.0.
 
integer $lockretrysleep = 150
 $lockretrysleep Used for memcached 3.x (PHP7), the amount of time to sleep between attempts to acquire the session lock.
 
string $prefix
 $prefix session key prefix

 
boolean $requireswritelock = false
 $requireswritelock does the session need and/or have a lock?
 
string $savepath
 $savepath save_path string

 
array $servers
 $servers list of servers parsed from save_path
 

Detailed Description

Memcached based session handler.

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.

◆ connection_string_to_memcache_servers()

static core\session\memcached::connection_string_to_memcache_servers ( string $str)
staticprotected

Convert a connection string to an array of servers.

"abc:123, xyz:789" to [ ['abc', '123'], ['xyz', '789'], ]

Parameters
string$strsave_path value containing memcached connection string
Return values
array[]

◆ init()

core\session\memcached::init ( )

Init session handler.

Reimplemented from core\session\handler.

◆ kill_all_sessions()

core\session\memcached::kill_all_sessions ( )

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

Reimplemented from core\session\handler.

◆ kill_session()

core\session\memcached::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
booltrue if session is intended to have a write lock.

◆ session_exists()

core\session\memcached::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
booltrue 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$requireswritelocktrue if needs to be open for writing

◆ start()

core\session\memcached::start ( )

Start the session.

Return values
boolsuccess

Reimplemented from core\session\handler.

◆ 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.

Member Data Documentation

◆ $lockretrysleep

integer core\session\memcached::$lockretrysleep = 150
protected

$lockretrysleep Used for memcached 3.x (PHP7), the amount of time to sleep between attempts to acquire the session lock.

Mimics the deprecated config memcached.sess_lock_wait.


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