class.ilTestSession.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
class ilTestSession
{
    public const ACCESS_CODE_SESSION_INDEX = "tst_access_code";
    public const ACCESS_CODE_CHAR_DOMAIN = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
    public const ACCESS_CODE_LENGTH = 5;
 
    private int $ref_id = 0;
    private int $pass = 0;
    public int $active_id = 0;
    public int $user_id = 0;
    public string $anonymous_id = '';
    public int $test_id = 0;
    public int $lastsequence = 0;
    protected ?string $lastPresentationMode = null;
    public bool $submitted = false;
    public int $tstamp = 0;
    public string $submittedTimestamp = '';
    private ?int $objectiveOrientedContainerId = null;
 
    private ?int $lastFinishedPass = null;
    private ?int $lastStartedPass = null;
 
 
    public function __construct(
        protected ilDBInterface $db,
        protected ilObjUser $user
    ) {
    }
 
    public function setRefId(int $ref_id): void
    {
        $this->ref_id = $ref_id;
    }
 
    public function getRefId(): int
    {
        return $this->ref_id;
    }
 
    protected function activeIDExists(int $user_id, int $test_id): bool
    {
        if ($this->user->getId() === ANONYMOUS_USER_ID) {
            return false;
        }
 
        $result = $this->db->queryF(
            "SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s",
            ['integer','integer'],
            [$user_id, $test_id]
        );
        if ($result->numRows()) {
            $row = $this->db->fetchAssoc($result);
            $this->active_id = (int) $row["active_id"];
            $this->user_id = (int) $row["user_fi"];
            $this->anonymous_id = $row["anonymous_id"] ?? '';
            $this->test_id = (int) $row["test_fi"];
            $this->lastsequence = (int) $row["lastindex"];
            $this->pass = (int) $row["tries"];
            $this->submitted = ($row["submitted"]) ? true : false;
            $this->submittedTimestamp = (string) $row["submittimestamp"];
            $this->tstamp = (int) $row["tstamp"];
 
            $this->lastStartedPass = $row['last_started_pass'];
            $this->lastFinishedPass = $row['last_finished_pass'];
            $this->objectiveOrientedContainerId = $row['objective_container'];
 
            return true;
        }
        return false;
    }
 
    public function increaseTestPass(): void
    {
        if (!$this->active_id) {
            throw new ilTestException('missing active id on test pass increase!');
        }
 
        $this->increasePass();
        $this->setLastSequence(0);
        $submitted = ($this->isSubmitted()) ? 1 : 0;
        $active = ilSession::get((string) $this->active_id);
        if (!isset($active['tst_last_increase_pass']) || $active['tst_last_increase_pass'] !== null) {
            $active['tst_last_increase_pass'] = 0;
        }
 
        // there has to be at least 10 seconds between new test passes (to ensure that noone double clicks the finish button and increases the test pass by more than 1)
        if (time() - $active['tst_last_increase_pass'] > 10) {
            $active['tst_last_increase_pass'] = time();
            $this->tstamp = time();
            $submittedtimestamp = $this->getSubmittedTimestamp() !== null && $this->getSubmittedTimestamp() !== '' ? $this->getSubmittedTimestamp() : null;
            $this->db->update(
                'tst_active',
                [
                    'lastindex' => ['integer', $this->getLastSequence()],
                    'tries' => ['integer', $this->getPass()],
                    'submitted' => ['integer', $submitted],
                    'submittimestamp' => ['timestamp', $submittedtimestamp],
                    'tstamp' => ['integer', time()],
                    'last_finished_pass' => ['integer', $this->getLastFinishedPass()],
                    'last_started_pass' => ['integer', $this->getLastStartedPass()],
                    'objective_container' => ['integer', $this->getObjectiveOrientedContainerId()]
                ],
                [
                    'active_id' => ['integer', $this->getActiveId()]
                ]
            );
        }
    }
 
    public function saveToDb(): void
    {
        $submitted = ($this->isSubmitted()) ? 1 : 0;
        $submittedtimestamp = $this->getSubmittedTimestamp() !== null && $this->getSubmittedTimestamp() !== '' ? $this->getSubmittedTimestamp() : null;
        if ($this->active_id > 0) {
            $this->db->update(
                'tst_active',
                [
                    'lastindex' => ['integer', $this->getLastSequence()],
                    'tries' => ['integer', $this->getPass()],
                    'submitted' => ['integer', $submitted],
                    'submittimestamp' => ['timestamp', $submittedtimestamp],
                    'tstamp' => ['integer', time() - 10],
                    'last_finished_pass' => ['integer', $this->getLastFinishedPass()],
                    'last_started_pass' => ['integer', $this->getPass()],
                    'objective_container' => ['integer', $this->getObjectiveOrientedContainerId()]
                ],
                [
                    'active_id' => ['integer', $this->getActiveId()]
                ]
            );
            return;
        }
 
        if (!$this->activeIDExists($this->getUserId(), $this->getTestId())) {
            $anonymous_id = $this->getAnonymousId() ?: null;
 
            $next_id = $this->db->nextId('tst_active');
            $this->db->insert(
                'tst_active',
                [
                    'active_id' => ['integer', $next_id],
                    'user_fi' => ['integer', $this->getUserId()],
                    'anonymous_id' => ['text', $anonymous_id],
                    'test_fi' => ['integer', $this->getTestId()],
                    'lastindex' => ['integer', $this->getLastSequence()],
                    'tries' => ['integer', $this->getPass()],
                    'submitted' => ['integer', $submitted],
                    'submittimestamp' => ['timestamp', (strlen($this->getSubmittedTimestamp())) ? $this->getSubmittedTimestamp() : null],
                    'tstamp' => ['integer', time() - 10],
                    'last_finished_pass' => ['integer', $this->getLastFinishedPass()],
                    'last_started_pass' => ['integer', $this->getPass()],
                    'objective_container' => ['integer', $this->getObjectiveOrientedContainerId()]
                ]
            );
            $this->active_id = $next_id;
        }
    }
 
    public function loadTestSession(int $test_id, int $user_id = 0, ?string $anonymous_id = null): void
    {
        if ($user_id === 0) {
            $user_id = $this->user->getId();
        }
        if (($this->user->getId() == ANONYMOUS_USER_ID) && $this->doesAccessCodeInSessionExists()) {
            $result = $this->db->queryF(
                "SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s",
                ['integer','integer','text'],
                [$user_id, $test_id, $this->getAccessCodeFromSession()]
            );
        } elseif ($anonymous_id !== null) {
            $result = $this->db->queryF(
                "SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s AND anonymous_id = %s",
                ['integer','integer','text'],
                [$user_id, $test_id, $anonymous_id]
            );
        } else {
            if ($this->user->getId() == ANONYMOUS_USER_ID) {
                return;
            }
            $result = $this->db->queryF(
                "SELECT * FROM tst_active WHERE user_fi = %s AND test_fi = %s",
                ['integer','integer'],
                [$user_id, $test_id]
            );
        }
 
        // TODO bheyser: Refactor
        $this->user_id = $user_id;
 
        if ($result->numRows()) {
            $row = $this->db->fetchAssoc($result);
            $this->active_id = $row["active_id"];
            $this->user_id = $row["user_fi"];
            $this->anonymous_id = $row["anonymous_id"] ?? '';
            $this->test_id = $row["test_fi"];
            $this->lastsequence = $row["lastindex"];
            $this->pass = $row["tries"];
            $this->submitted = ($row["submitted"]) ? true : false;
            $this->submittedTimestamp = $row["submittimestamp"] ?? '';
            $this->tstamp = $row["tstamp"];
            $this->lastStartedPass = $row['last_started_pass'];
            $this->lastFinishedPass = $row['last_finished_pass'];
            $this->setObjectiveOrientedContainerId((int) $row['objective_container']);
        } elseif ($this->doesAccessCodeInSessionExists()) {
            $this->unsetAccessCodeInSession();
        }
    }
 
    public function loadFromDb(int $active_id): void
    {
        $result = $this->db->queryF(
            "SELECT * FROM tst_active WHERE active_id = %s",
            ['integer'],
            [$active_id]
        );
        if ($result->numRows()) {
            $row = $this->db->fetchAssoc($result);
            $this->active_id = $row["active_id"];
            $this->user_id = $row["user_fi"];
            $this->anonymous_id = $row["anonymous_id"] ?? '';
            $this->test_id = $row["test_fi"];
            $this->lastsequence = $row["lastindex"];
            $this->pass = $row["tries"];
            $this->submitted = ($row["submitted"]) ? true : false;
            $this->submittedTimestamp = $row["submittimestamp"] ?? '';
            $this->tstamp = $row["tstamp"];
 
            $this->lastStartedPass = $row['last_started_pass'];
            $this->lastFinishedPass = $row['last_finished_pass'];
            $this->setObjectiveOrientedContainerId((int) $row['objective_container']);
        }
    }
 
    public function getActiveId(): int
    {
        return $this->active_id;
    }
 
    public function setUserId(int $user_id): void
    {
        $this->user_id = $user_id;
    }
 
    public function getUserId(): int
    {
        return $this->user_id;
    }
 
    public function setTestId(int $test_id): void
    {
        $this->test_id = $test_id;
    }
 
    public function getTestId(): int
    {
        return $this->test_id;
    }
 
    public function setAnonymousId(string $anonymous_id): void
    {
        $this->anonymous_id = $anonymous_id;
    }
 
    public function getAnonymousId(): string
    {
        return $this->anonymous_id;
    }
 
    public function setLastSequence(int $lastsequence): void
    {
        $this->lastsequence = $lastsequence;
    }
 
    public function getLastSequence(): int
    {
        return $this->lastsequence;
    }
 
    public function setPass(int $pass): void
    {
        $this->pass = $pass;
    }
 
    public function getPass(): int
    {
        return $this->pass;
    }
 
    public function increasePass()
    {
        $this->pass += 1;
    }
 
    public function isSubmitted(): bool
    {
        return $this->submitted;
    }
 
    public function setSubmitted(): void
    {
        $this->submitted = true;
    }
 
    public function getSubmittedTimestamp(): ?string
    {
        return $this->submittedTimestamp;
    }
 
    public function setSubmittedTimestamp(): void
    {
        $this->submittedTimestamp = date('Y-m-d H:i:s');
    }
 
    public function setLastFinishedPass(int $lastFinishedPass): void
    {
        $this->lastFinishedPass = $lastFinishedPass;
    }
 
    public function getLastFinishedPass(): ?int
    {
        return $this->lastFinishedPass;
    }
 
    public function setObjectiveOrientedContainerId(int $objectiveOriented): void
    {
        $this->objectiveOrientedContainerId = $objectiveOriented;
    }
 
    public function getObjectiveOrientedContainerId(): int
    {
        return $this->objectiveOrientedContainerId ?? 0;
    }
 
    public function getLastStartedPass(): ?int
    {
        return $this->lastStartedPass;
    }
 
    public function setLastStartedPass(int $lastStartedPass): void
    {
        $this->lastStartedPass = $lastStartedPass;
    }
 
    public function isObjectiveOriented(): bool
    {
        return (bool) $this->getObjectiveOrientedContainerId();
    }
 
    public function persistTestStartLock(string $testStartLock): void
    {
        $this->db->update(
            'tst_active',
            ['start_lock' => ['text', $testStartLock]],
            ['active_id' => ['integer', $this->getActiveId()]]
        );
    }
 
    public function lookupTestStartLock(): ?string
    {
        $res = $this->db->queryF(
            "SELECT start_lock FROM tst_active WHERE active_id = %s",
            ['integer'],
            [$this->getActiveId()]
        );
 
        while ($row = $this->db->fetchAssoc($res)) {
            return $row['start_lock'];
        }
 
        return null;
    }
 
    public function setAccessCodeToSession(string $access_code): void
    {
        if (!is_array(ilSession::get(self::ACCESS_CODE_SESSION_INDEX))) {
            ilSession::set(self::ACCESS_CODE_SESSION_INDEX, []);
        }
        $session_code = ilSession::get(self::ACCESS_CODE_SESSION_INDEX);
        $session_code[$this->getTestId()] = $access_code;
        ilSession::set(self::ACCESS_CODE_SESSION_INDEX, $session_code);
    }
 
    public function unsetAccessCodeInSession(): void
    {
        $session_code = ilSession::get(self::ACCESS_CODE_SESSION_INDEX);
        unset($session_code[$this->getTestId()]);
        ilSession::set(self::ACCESS_CODE_SESSION_INDEX, $session_code);
    }
 
    public function getAccessCodeFromSession(): ?string
    {
        if (!is_array(ilSession::get(self::ACCESS_CODE_SESSION_INDEX))) {
            return null;
        }
        $session_code = ilSession::get(self::ACCESS_CODE_SESSION_INDEX);
        if (!isset($session_code[$this->getTestId()])) {
            return null;
        }
 
        return $session_code[$this->getTestId()];
    }
 
    public function doesAccessCodeInSessionExists(): bool
    {
        return is_array(ilSession::get(self::ACCESS_CODE_SESSION_INDEX)) && isset(ilSession::get(self::ACCESS_CODE_SESSION_INDEX)[$this->getTestId()]);
    }
 
    public function createNewAccessCode(): string
    {
        do {
            $code = $this->buildAccessCode();
        } while ($this->isAccessCodeUsed($code));
 
        return $code;
    }
 
    public function isAccessCodeUsed(string $code): bool
    {
        return $this->db->fetchObject(
            $this->db->queryF(
                'SELECT COUNT(anonymous_id) cnt FROM tst_active WHERE test_fi = %s AND anonymous_id = %s',
                [ilDBConstants::T_INTEGER, ilDBConstants::T_TEXT],
                [$this->getTestId(), $code]
            )
        )->cnt > 0;
    }
 
    private function buildAccessCode(): string
    {
        // create a 5 character code
        $codestring = self::ACCESS_CODE_CHAR_DOMAIN;
 
        mt_srand();
 
        $code = "";
 
        for ($i = 1; $i <= self::ACCESS_CODE_LENGTH; $i++) {
            $index = mt_rand(0, strlen($codestring) - 1);
            $code .= substr($codestring, $index, 1);
        }
 
        return $code;
    }
 
    public function isAnonymousUser(): bool
    {
        return $this->getUserId() == ANONYMOUS_USER_ID;
    }
 
    public function isPasswordChecked(): bool
    {
        if (ilSession::get('pw_checked_' . $this->active_id) === null) {
            return false;
        }
        return ilSession::get('pw_checked_' . $this->active_id);
    }
 
    public function setPasswordChecked(bool $value): void
    {
        ilSession::set('pw_checked_' . $this->active_id, $value);
    }
 
    private ?bool $reportable_results_available = null;
 
    public function reportableResultsAvailable(ilObjTest $test_obj): ?bool
    {
        if ($this->reportable_results_available === null) {
            $this->reportable_results_available = true;
 
            if (!$this->getActiveId()) {
                $this->reportable_results_available = false;
            }
 
            if (!$test_obj->canShowTestResults($this)) {
                $this->reportable_results_available = false;
            }
        }
 
        return $this->reportable_results_available;
    }
 
    public function hasSinglePassReportable(ilObjTest $testObj): bool
    {
        $test_passes_selector = new ilTestPassesSelector($this->db, $testObj);
        $test_passes_selector->setActiveId($this->getActiveId());
        $test_passes_selector->setLastFinishedPass($this->getLastFinishedPass());
 
        if (count($test_passes_selector->getReportablePasses()) == 1) {
            return true;
        }
 
        return false;
    }
}