Collaboration diagram for ilSessionControl:

Static Public Member Functions
static	handleLoginEvent (string $a_login, ilAuthSession $auth_session)
	when current session is allowed to be created it marks it with type regarding to the sessions user context. More...

static	handleLogoutEvent ()
	reset sessions type to unknown More...

static	getExistingSessionCount (array $a_types)
	returns number of valid sessions relating to given session types More...

static	getSettingFields ()
	returns the array of setting fields More...

Data Fields
const	DEFAULT_MIN_IDLE = 15
	default value for settings that have not been defined in setup or administration yet More...

const	DEFAULT_ALLOW_CLIENT_MAINTENANCE = 1

Static Public Attributes
static array	$session_types_controlled

Static Private Member Functions
static	isValidSession (string $a_sid)
	checks if session exists for given id and if it is still valid More...

static	removeSessionCookie ()
	removes a session cookie, so it is not sent by browser anymore More...

static	checkAdministrationPermission (int $a_user_id)
	checks wether a given user login relates to an user with administrative permissions More...

static	debug (string $a_debug_log_message)
	logs the given debug message in More...

Private Attributes
const	SESSION_TYPE_UNKNOWN = 0
	session types from which one is assigned to each session More...

const	SESSION_TYPE_SYSTEM = 1

const	SESSION_TYPE_ADMIN = 2

const	SESSION_TYPE_USER = 3

const	SESSION_TYPE_ANONYM = 4

const	SESSION_TYPE_KEY = "SessionType"

Static Private Attributes
static array	$setting_fields
	all fieldnames that are saved in settings table More...

static array	$session_types_not_controlled
	all session types that will be involved when count of sessions will be determined or when idleing sessions will be destroyed More...

Detailed Description

Author: Bjoern Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de

Definition at line 24 of file class.ilSessionControl.php.

Member Function Documentation

◆ checkAdministrationPermission()

static ilSessionControl::checkAdministrationPermission ( int $a_user_id )

staticprivate

checks wether a given user login relates to an user with administrative permissions

ilRbacSystem $rbacsystem

Returns: boolean access

Definition at line 202 of file class.ilSessionControl.php.

References $DIC, and SYSTEM_FOLDER_ID.

                                                                          : bool
     {
         if (!$a_user_id) {
             return false;
         }
 
         global $DIC;
 
         $rbacsystem = $DIC['rbacsystem'];
 
         $access = $rbacsystem->checkAccessOfUser(
             $a_user_id,
             'read,visible',
             SYSTEM_FOLDER_ID
         );
 
         return $access;
     }

◆ debug()

static ilSessionControl::debug ( string $a_debug_log_message )

staticprivate

logs the given debug message in

Parameters

string $a_debug_log_message

Definition at line 226 of file class.ilSessionControl.php.

References $DIC.

                                                               : void
     {
         global $DIC;
 
         $logger = $DIC->logger()->auth();
 
         $logger->debug($a_debug_log_message);
     }

◆ getExistingSessionCount()

static ilSessionControl::getExistingSessionCount ( array $a_types )

static

returns number of valid sessions relating to given session types

Definition at line 125 of file class.ilSessionControl.php.

References $DIC, $ilDB, $res, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilSessionStatisticsGUI\renderCurrentBasics().

                                                                   : int
     {
         global $DIC;
 
         $ilDB = $DIC['ilDB'];
 
         $ts = time();
 
         $query = "SELECT count(session_id) AS num_sessions FROM usr_session " .
                     "WHERE expires > %s " .
                     "AND " . $ilDB->in('type', $a_types, false, 'integer');
 
         $res = $ilDB->queryF($query, array('integer'), array($ts));
         return (int) $res->fetchRow(ilDBConstants::FETCHMODE_OBJECT)->num_sessions;
     }

Here is the caller graph for this function:

◆ getSettingFields()

static ilSessionControl::getSettingFields ( )

static

returns the array of setting fields

Returns: array setting_fields

Definition at line 240 of file class.ilSessionControl.php.

                                              : array
     {
         return self::$setting_fields;
     }

◆ handleLoginEvent()

static ilSessionControl::handleLoginEvent	(	string	$a_login,
		ilAuthSession	$auth_session
	)

static

when current session is allowed to be created it marks it with type regarding to the sessions user context.

when session is not allowed to be created it will be destroyed.

Definition at line 81 of file class.ilSessionControl.php.

References $DIC, $ilSetting, $user_id, ilObjUser\_lookupId(), ANONYMOUS_USER_ID, and ilSession\set().

Referenced by ilAuthFrontend\handleAuthenticationSuccess().

                                                                                          : bool
     {
         global $DIC;
 
         $ilSetting = $DIC['ilSetting'];
 
         $user_id = ilObjUser::_lookupId($a_login);
 
         // we need the session type for the session statistics
         // regardless of the current session handling type
         switch (true) {
             case isset($_ENV['SHELL']):
                 $type = self::SESSION_TYPE_SYSTEM;
                 break;
 
             case $user_id === ANONYMOUS_USER_ID:
                 $type = self::SESSION_TYPE_ANONYM;
                 break;
 
             case self::checkAdministrationPermission($user_id):
                 $type = self::SESSION_TYPE_ADMIN;
                 break;
 
             default:
                 $type = self::SESSION_TYPE_USER;
                 break;
         }
 
         ilSession::set(self::SESSION_TYPE_KEY, $type);
         self::debug(__METHOD__ . " --> update sessions type to (" . $type . ")");
 
         return true;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handleLogoutEvent()

static ilSessionControl::handleLogoutEvent ( )

static

reset sessions type to unknown

Definition at line 118 of file class.ilSessionControl.php.

                                               : void
     {
     }

◆ isValidSession()

static ilSessionControl::isValidSession ( string $a_sid )

staticprivate

checks if session exists for given id and if it is still valid

Returns: boolean session_valid

Definition at line 147 of file class.ilSessionControl.php.

References $DIC, $ilDB, and $res.

                                                          : bool
     {
         global $DIC;
 
         $ilDB = $DIC['ilDB'];
 
         $query = "SELECT session_id, expires FROM usr_session " .
                     "WHERE session_id = %s";
 
         $res = $ilDB->queryF($query, array('text'), array($a_sid));
 
         $ts = time();
 
         $sessions = array();
 
         while ($row = $ilDB->fetchAssoc($res)) {
             if ($row['expires'] > $ts) {
                 self::debug(__METHOD__ . ' --> Found a valid session with id (' . $a_sid . ')');
                 $sessions[] = $row;
             } else {
                 self::debug(__METHOD__ . ' --> Found an expired session with id (' . $a_sid . ')');
             }
         }
 
         if (count($sessions) === 1) {
             self::debug(__METHOD__ . ' --> Exact one valid session found for session id (' . $a_sid . ')');
 
             return true;
         }
 
         if (count($sessions) > 1) {
             self::debug(__METHOD__ . ' --> Strange!!! More than one sessions found for given session id! (' . $a_sid . ')');
         } else {
             self::debug(__METHOD__ . ' --> No valid session found for session id (' . $a_sid . ')');
         }
 
         return false;
     }

◆ removeSessionCookie()

static ilSessionControl::removeSessionCookie ( )

staticprivate

removes a session cookie, so it is not sent by browser anymore

Definition at line 189 of file class.ilSessionControl.php.

References ilUtil\setCookie().

                                                  : void
     {
         ilUtil::setCookie(session_name(), 'deleted', true, true);
         self::debug('Session cookie has been removed');
     }

Here is the call graph for this function:

Field Documentation

◆ $session_types_controlled

array ilSessionControl::$session_types_controlled

static

Initial value:

= array(
        self::SESSION_TYPE_USER,
        self::SESSION_TYPE_ANONYM
    )

Definition at line 59 of file class.ilSessionControl.php.

Referenced by ilSessionStatistics\getNumberOfActiveRawSessions(), ilSessionStatistics\getRawData(), ilSession\lookupExpireTime(), and ilSessionStatisticsGUI\renderCurrentBasics().

◆ $session_types_not_controlled

array ilSessionControl::$session_types_not_controlled

staticprivate

Initial value:

= array(
        self::SESSION_TYPE_UNKNOWN,
        self::SESSION_TYPE_SYSTEM,
        self::SESSION_TYPE_ADMIN
    )

all session types that will be involved when count of sessions will be determined or when idleing sessions will be destroyed

all session types that will be ignored when count of sessions will be determined or when idleing sessions will be destroyed

Definition at line 70 of file class.ilSessionControl.php.

◆ $setting_fields

array ilSessionControl::$setting_fields

staticprivate

Initial value:

= array(
        'session_allow_client_maintenance',
    )

all fieldnames that are saved in settings table

Definition at line 38 of file class.ilSessionControl.php.

◆ DEFAULT_ALLOW_CLIENT_MAINTENANCE

const ilSessionControl::DEFAULT_ALLOW_CLIENT_MAINTENANCE = 1

Definition at line 31 of file class.ilSessionControl.php.

Referenced by ilObjUserFolderGUI\initFormGeneralSettings().

◆ DEFAULT_MIN_IDLE

const ilSessionControl::DEFAULT_MIN_IDLE = 15

default value for settings that have not been defined in setup or administration yet

Definition at line 30 of file class.ilSessionControl.php.

Referenced by ilObjSCORMInitData\getIliasScormVars(), and ilSCORM13PlayerGUI\getPlayer().

◆ SESSION_TYPE_ADMIN

const ilSessionControl::SESSION_TYPE_ADMIN = 2

private

Definition at line 48 of file class.ilSessionControl.php.

◆ SESSION_TYPE_ANONYM

const ilSessionControl::SESSION_TYPE_ANONYM = 4

private

Definition at line 50 of file class.ilSessionControl.php.

◆ SESSION_TYPE_KEY

const ilSessionControl::SESSION_TYPE_KEY = "SessionType"

private

Definition at line 52 of file class.ilSessionControl.php.

◆ SESSION_TYPE_SYSTEM

const ilSessionControl::SESSION_TYPE_SYSTEM = 1

private

Definition at line 47 of file class.ilSessionControl.php.

◆ SESSION_TYPE_UNKNOWN

const ilSessionControl::SESSION_TYPE_UNKNOWN = 0

private

session types from which one is assigned to each session

Definition at line 46 of file class.ilSessionControl.php.

◆ SESSION_TYPE_USER

const ilSessionControl::SESSION_TYPE_USER = 3

private

Definition at line 49 of file class.ilSessionControl.php.

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

components/ILIAS/Authentication/classes/class.ilSessionControl.php

Static Public Member Functions

Data Fields

Static Public Attributes

Static Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Function Documentation

◆ checkAdministrationPermission()

◆ debug()

◆ getExistingSessionCount()

◆ getSettingFields()

◆ handleLoginEvent()

◆ handleLogoutEvent()

◆ isValidSession()

◆ removeSessionCookie()

Field Documentation

◆ $session_types_controlled

◆ $session_types_not_controlled

◆ $setting_fields

◆ DEFAULT_ALLOW_CLIENT_MAINTENANCE

◆ DEFAULT_MIN_IDLE

◆ SESSION_TYPE_ADMIN

◆ SESSION_TYPE_ANONYM

◆ SESSION_TYPE_KEY

◆ SESSION_TYPE_SYSTEM

◆ SESSION_TYPE_UNKNOWN

◆ SESSION_TYPE_USER