Class CakeSession

Session class for Cake.

Cake abstracts the handling of sessions. There are several convenient methods to access session information. This class is the implementation of those methods. They are mostly used by the Session Component.

Object

CakeSession

Direct Subclasses

Package: cake\cake\libs
Copyright: Copyright 2005-2012, Cake Software Foundation, Inc. (http://cakefoundation.org)
License: License (http://www.opensource.org/licenses/mit-license.php)
Location: cake_session.php

Properties summary

$_userAgent public

string

User agent string
$cookieLifeTime public

integer

The number of seconds to set for session.cookie_lifetime. 0 means at browser close.
$error public

array

Error messages for this session
$host public

string

Hostname
$id public

string

Current Session id
$lastError public

integer

Error number of last occurred error
$path public

string

Path to where the session is active.
$security public

string

'Security.level' setting, "high", "medium", or "low".
$sessionTime public

integer

Time when this session becomes invalid.
$time public

integer

Start time for this session.
$timeout public

integer

Session timeout multiplier factor
$valid public

boolean

True if the Session is still valid
$watchKeys public

array

Keeps track of keys to watch for writes on

Method Summary

__close() public

Method called on close of a database session.
__construct() public

Constructor.
__destroy() public

Method called on the destruction of a database session.
__error() public

Return error description for given error number.
__gc() public

Helper function called on gc for database sessions.
__initSession() public

Helper method to initialize a session, based on Cake core settings.
__open() public

Method called on open of a database session.
__overwrite() public

Used to write new data to _SESSION, since PHP doesn't like us setting the _SESSION var itself
__read() public

Method used to read from a database session.
__regenerateId() public

Helper method to restart a session.
__returnSessionVars() public

Returns all session variables.
__setError() public

Helper method to set an internal error message.
__startSession() public

Helper method to start a session
__write() public

Helper function called on write for database sessions.
_checkValid() public

Helper method to create a new session.
check() public

Returns true if given variable is set in session.
delete() public

Removes a variable from session.
destroy() public

Helper method to destroy invalid sessions.
error() public

Returns last occurred error as a string, if any.
id() public

Returns the Session id
ignore() public

Tells Session to stop watching a given key path
read() public

Returns given session variable, or all of them, if no parameters given.
renew() public

Restarts this session.
start() public

Starts the Session.
started() public

Determine if Session has been started.
valid() public

Returns true if session is valid.
watch() public

Tells Session to write a notification when a certain session path or subpath is written to
write() public

Writes value to given session variable name.

Method Detail

__close() public ¶

__close( )

Method called on close of a database session.

Returns

boolean
Success

__construct() public ¶

__construct( string $base = null , boolean $start = true )

Constructor.

Parameters

string $base optional null: The base path for the Session
boolean $start optional true: Should session be started right now

Overrides

Object::__construct()

__destroy() public ¶

__destroy( integer $id )

Method called on the destruction of a database session.

Parameters

integer $id: ID that uniquely identifies session in database

Returns

boolean
True for successful delete, false otherwise.

__error() public ¶

__error( integer $errorNumber )

Return error description for given error number.

Parameters

integer $errorNumber: Error to set

Returns

string
Error as string

__gc() public ¶

__gc( integer $expires = null )

Helper function called on gc for database sessions.

Parameters

integer $expires optional null: Timestamp (defaults to current time)

Returns

boolean
Success

__initSession() public ¶

__initSession( )

Helper method to initialize a session, based on Cake core settings.

__open() public ¶

__open( )

Method called on open of a database session.

Returns

boolean
Success

__overwrite() public ¶

__overwrite( array $old , array $new )

Used to write new data to _SESSION, since PHP doesn't like us setting the _SESSION var itself

Parameters

array $old: Set of old variables => values
array $new: New set of variable => value

__read() public ¶

__read( mixed $id )

Method used to read from a database session.

Parameters

mixed $id: The key of the value to read

Returns

mixed
The value of the key or false if it does not exist

__regenerateId() public ¶

__regenerateId( )

Helper method to restart a session.

__returnSessionVars() public ¶

__returnSessionVars( )

Returns all session variables.

Returns

mixed
Full $_SESSION array, or false on error.

__setError() public ¶

__setError( integer $errorNumber , string $errorMessage )

Helper method to set an internal error message.

Parameters

integer $errorNumber: Number of the error
string $errorMessage: Description of the error

__startSession() public ¶

__startSession( )

Helper method to start a session

__write() public ¶

__write( integer $id , mixed $data )

Helper function called on write for database sessions.

Parameters

integer $id: ID that uniquely identifies session in database
mixed $data: The value of the data to be saved.

Returns

boolean
True for successful write, false otherwise.

_checkValid() public ¶

_checkValid( )

Helper method to create a new session.

check() public ¶

check( string $name )

Returns true if given variable is set in session.

Parameters

string $name: Variable name to check for

Returns

boolean
True if variable is there

delete() public ¶

delete( string $name )

Removes a variable from session.

Parameters

string $name: Session variable to remove

Returns

boolean
Success

destroy() public ¶

destroy( )

Helper method to destroy invalid sessions.

error() public ¶

error( )

Returns last occurred error as a string, if any.

Returns

mixed
Error description as a string, or false.

id() public ¶

id( CakeSession::$id $id = null )

Returns the Session id

Parameters

CakeSession::$id $id optional null: $name string

Returns

string
Session id

ignore() public ¶

ignore( mixed $var )

Tells Session to stop watching a given key path

Parameters

mixed $var: The variable path to watch

read() public ¶

read( mixed $name = null )

Returns given session variable, or all of them, if no parameters given.

Parameters

mixed $name optional null: The name of the session variable (or a path as sent to Set.extract)

Returns

mixed
The value of the session variable

renew() public ¶

renew( )

Restarts this session.

start() public ¶

start( )

Starts the Session.

Returns

boolean
True if session was started

started() public ¶

started( )

Determine if Session has been started.

Returns

boolean
True if session has been started.

valid() public ¶

valid( )

Returns true if session is valid.

Returns

boolean
Success

watch() public ¶

watch( mixed $var )

Tells Session to write a notification when a certain session path or subpath is written to

Parameters

mixed $var: The variable path to watch

write() public ¶

write( mixed $name , string $value )

Writes value to given session variable name.

Parameters

mixed $name: Name of variable
string $value: Value to write

Returns

boolean
True if the write was successful, false if the write failed

Methods inherited from Object

Object() public ¶

Object( )

A hack to support __construct() on PHP 4 Hint: descendant classes have no PHP4 class_name() constructors, so this constructor gets called first and calls the top-layer __construct() which (if present) should call parent::__construct()

Returns

Object

__openPersistent() public ¶

__openPersistent( string $name , string $type = null )

Open the persistent class file for reading Used by Object::_persist()

Parameters

string $name: Name of persisted class
string $type optional null: Type of persistance (e.g: registry)

_persist() public ¶

_persist( string $name , string $return , $object , $type = null )

Checks for a persistent class file, if found file is opened and true returned If file is not found a file is created and false returned If used in other locations of the model you should choose a unique name for the persistent file There are many uses for this method, see manual for examples

Parameters

string $name: name of the class to persist
string $return: $object the object to persist
$object
$type optional null

Returns

boolean
Success

_savePersistent() public ¶

_savePersistent( string $name , object $object )

You should choose a unique name for the persistent file

There are many uses for this method, see manual for examples

Parameters

string $name: name used for object to cache
object $object: the object to persist

Returns

boolean
true on save, throws error if file can not be created

_set() public ¶

_set( array $properties = array() )

Allows setting of multiple properties of the object in a single line of code. Will only set properties that are part of a class declaration.

Parameters

array $properties optional array(): An associative array containing properties and corresponding values.

_stop() public ¶

_stop( $status = 0 )

Stop execution of the current script. Wraps exit() making testing easier.

Parameters

$status optional 0: http://php.net/exit for values

cakeError() public ¶

cakeError( string $method , array $messages = array() )

Used to report user friendly errors. If there is a file app/error.php or app/app_error.php this file will be loaded error.php is the AppError class it should extend ErrorHandler class.

Parameters

string $method: Method to be called in the error class (AppError or ErrorHandler classes)
array $messages optional array(): Message that is to be displayed by the error class

Returns

error
message

dispatchMethod() public ¶

dispatchMethod( string $method , array $params = array() )

Calls a method on this object with the given parameters. Provides an OO wrapper for call_user_func_array

Parameters

string $method: Name of the method to call
array $params optional array(): Parameter list to use when calling $method

Returns

mixed
Returns the result of the method call

log() public ¶

log( string $msg , integer $type = LOG_ERROR )

Convience method to write a message to CakeLog. See CakeLog::write() for more information on writing to logs.

Parameters

string $msg: Log message
integer $type optional LOG_ERROR: Error type constant. Defined in app/config/core.php.

Returns

boolean
Success of log write

requestAction() public ¶

requestAction( mixed $url , array $extra = array() )

Calls a controller's method from any location. Can be used to connect controllers together or tie plugins into a main application. requestAction can be used to return rendered views or fetch the return value from controller actions.

Parameters

mixed $url: String or array-based url.
array $extra optional array(): if array includes the key "return" it sets the AutoRender to true.

Returns

mixed

Boolean true or false on success/failure, or contents of rendered action if 'return' is set in $extra.

toString() public ¶

toString( )

Object-to-string conversion. Each class can override this method as necessary.

Returns

string
The name of this class

Properties detail

`$_userAgent` ¶

public string

User agent string

''

`$cookieLifeTime` ¶

public integer

The number of seconds to set for session.cookie_lifetime. 0 means at browser close.

false

`$error` ¶

public array

Error messages for this session

false

`$host` ¶

public string

Hostname

null

`$id` ¶

public string

Current Session id

null

`$lastError` ¶

public integer

Error number of last occurred error

null

`$path` ¶

public string

Path to where the session is active.

'/'

`$security` ¶

public string

'Security.level' setting, "high", "medium", or "low".

null

`$sessionTime` ¶

public integer

Time when this session becomes invalid.

false

`$time` ¶

public integer

Start time for this session.

false

`$timeout` ¶

public integer

Session timeout multiplier factor

null

`$valid` ¶

public boolean

True if the Session is still valid

false

`$watchKeys` ¶

public array

Keeps track of keys to watch for writes on

array()

Classes

Functions

Class CakeSession

Direct Subclasses

Properties summary

Method Summary

__close() public

__construct() public

__destroy() public

__error() public

__gc() public

__initSession() public

__open() public

__overwrite() public

__read() public

__regenerateId() public

__returnSessionVars() public

__setError() public

__startSession() public

__write() public

_checkValid() public

check() public

delete() public

destroy() public

error() public

id() public

ignore() public

read() public

renew() public

start() public

started() public

valid() public

watch() public

write() public

Method Detail

__close() public ¶

Returns

__construct() public ¶

Parameters

Overrides

__destroy() public ¶

Parameters

Returns

__error() public ¶

Parameters

Returns

__gc() public ¶

Parameters

Returns

__initSession() public ¶

__open() public ¶

Returns

__overwrite() public ¶

Parameters

__read() public ¶

Parameters

Returns

__regenerateId() public ¶

__returnSessionVars() public ¶

Returns

__setError() public ¶

Parameters

__startSession() public ¶

__write() public ¶

Parameters

Returns

_checkValid() public ¶

check() public ¶

Parameters

Returns

delete() public ¶

Parameters

Returns

destroy() public ¶

error() public ¶

Returns

id() public ¶

Parameters

Returns

ignore() public ¶