inc.pwassist_session_handler.php File Reference

Go to the source code of this file.

Functions
	db_pwassist_create_id ()
	Creates a new secure id. More...
	db_pwassist_session_read (string $pwassist_id)
	db_pwassist_session_find (int $user_id)
	db_pwassist_session_write (string $pwassist_id, int $maxlifetime, int $user_id)
	db_pwassist_session_destroy (string $pwassist_id)
	db_pwassist_session_gc ()

Function Documentation

db_pwassist_create_id()

db_pwassist_create_id

(

)

Creates a new secure id.

The secure id has the following characteristics:

• It is unique
• It is a non-uniformly distributed (pseudo) random value
• Only a non-substantial number of bits can be predicted from previously generated id's.

Definition at line 30 of file inc.pwassist_session_handler.php.

References $DIC, $ilDB, ilPasswordUtils\getBytes(), ILIAS\Repository\int(), and ilDBConstants\T_TEXT.

Referenced by ilPasswordAssistanceGUI\submitAssistanceForm().

                                : string
{
    global $DIC;

    $ilDB = $DIC->database();

    do {
        $hash = bin2hex(ilPasswordUtils::getBytes(32));

        $exists = (
            (int) ($ilDB->fetchAssoc(
                $ilDB->query(
                    "SELECT EXISTS(" .
                    "SELECT 1 FROM usr_pwassist WHERE pwassist_id = " . $ilDB->quote($hash, ilDBConstants::T_TEXT) .
                    ") AS hit"
                )
            )['hit'] ?? 0) === 1
        );
    } while ($exists);

    return $hash;
}

Here is the call graph for this function:

Here is the caller graph for this function:

db_pwassist_session_destroy()

db_pwassist_session_destroy

(

string

$pwassist_id

)

Definition at line 103 of file inc.pwassist_session_handler.php.

References $DIC, $ilDB, $q, and ilDBConstants\T_TEXT.

Referenced by ilPasswordAssistanceGUI\submitAssignPasswordForm(), and ilSessionTest\testPasswordAssisstanceSession().

                                                         : void
{
    global $DIC;

    $ilDB = $DIC->database();

    $q = 'DELETE FROM usr_pwassist WHERE pwassist_id = ' . $ilDB->quote($pwassist_id, ilDBConstants::T_TEXT);
    $ilDB->manipulate($q);
}

Here is the caller graph for this function:

db_pwassist_session_find()

db_pwassist_session_find

(

int

$user_id

)

Returns

null|array{"pwassist_id": string, "expires": int|numeric-string, "user_id": int|numeric-string, "ctime": int|numeric-string}

Definition at line 71 of file inc.pwassist_session_handler.php.

References $DIC, $ilDB, $q, $r, and ilDBConstants\T_INTEGER.

Referenced by ilSessionTest\testPasswordAssisstanceSession().

                                               : ?array
{
    global $DIC;

    $ilDB = $DIC->database();

    $q = 'SELECT * FROM usr_pwassist WHERE user_id = ' . $ilDB->quote($user_id, ilDBConstants::T_INTEGER);
    $r = $ilDB->query($q);

    return $ilDB->fetchAssoc($r);
}

Here is the caller graph for this function:

db_pwassist_session_gc()

db_pwassist_session_gc

(

)

Definition at line 114 of file inc.pwassist_session_handler.php.

References $DIC, $ilDB, $q, and ilDBConstants\T_INTEGER.

Referenced by ilSessionTest\testPasswordAssisstanceSession().

                                 : void
{
    global $DIC;

    $ilDB = $DIC->database();

    $q = 'DELETE FROM usr_pwassist WHERE expires < ' . $ilDB->quote(time(), ilDBConstants::T_INTEGER);
    $ilDB->manipulate($q);
}

Here is the caller graph for this function:

db_pwassist_session_read()

db_pwassist_session_read

(

string

$pwassist_id

)

Returns

null|array{"pwassist_id": string, "expires": int|numeric-string, "user_id": int|numeric-string, "ctime": int|numeric-string}

Definition at line 56 of file inc.pwassist_session_handler.php.

References $DIC, $ilDB, $q, $r, and ilDBConstants\T_TEXT.

Referenced by ilPasswordAssistanceGUI\showAssignPasswordForm(), ilPasswordAssistanceGUI\submitAssignPasswordForm(), and ilSessionTest\testPasswordAssisstanceSession().

                                                      : ?array
{
    global $DIC;

    $ilDB = $DIC->database();

    $q = 'SELECT * FROM usr_pwassist WHERE pwassist_id = ' . $ilDB->quote($pwassist_id, ilDBConstants::T_TEXT);
    $r = $ilDB->query($q);

    return $ilDB->fetchAssoc($r);
}

Here is the caller graph for this function:

db_pwassist_session_write()

db_pwassist_session_write	(	string	$pwassist_id,
		int	$maxlifetime,
		int	$user_id
	)

Definition at line 83 of file inc.pwassist_session_handler.php.

References $DIC, $ilDB, $q, ilDBConstants\T_INTEGER, and ilDBConstants\T_TEXT.

Referenced by ilPasswordAssistanceGUI\submitAssistanceForm(), and ilSessionTest\testPasswordAssisstanceSession().

                                                                                       : void
{
    global $DIC;

    $ilDB = $DIC->database();

    $q = 'DELETE FROM usr_pwassist ' .
        'WHERE pwassist_id = ' . $ilDB->quote($pwassist_id, ilDBConstants::T_TEXT) . ' ' .
        'OR user_id = ' . $ilDB->quote($user_id, ilDBConstants::T_INTEGER);
    $ilDB->manipulate($q);

    $ctime = time();
    $expires = $ctime + $maxlifetime;
    $ilDB->manipulateF(
        'INSERT INTO usr_pwassist (pwassist_id, expires, user_id,  ctime)  VALUES (%s, %s, %s, %s)',
        [ilDBConstants::T_TEXT, ilDBConstants::T_INTEGER, ilDBConstants::T_INTEGER, ilDBConstants::T_INTEGER],
        [$pwassist_id, $expires, $user_id, $ctime]
    );
}

Here is the caller graph for this function: