SubmissionManager.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\Exercise\Submission;
 
use ILIAS\Exercise\InternalRepoService;
use ILIAS\Exercise\InternalDomainService;
use ILIAS\FileUpload\DTO\UploadResult;
use ILIAS\Filesystem\Stream\FileStream;
 
class SubmissionManager
{
    protected \ilExAssignmentTypeInterface $type;
    protected \ILIAS\Exercise\Team\TeamManager $team;
    protected \ilLogger $log;
    protected SubmissionRepositoryInterface $repo;
    protected \ilExAssignment $assignment;
 
    public function __construct(
        InternalRepoService $repo,
        protected InternalDomainService $domain,
        protected \ilExcSubmissionStakeholder $stakeholder,
        protected int $ass_id
    ) {
        $this->assignment = $domain->assignment()->getAssignment($ass_id);
        $this->type = $this->assignment->getAssignmentType();
        $this->repo = $repo->submission();
        $this->log = $this->domain->logger()->exc();
        $this->team = $domain->team();
    }
 
    public function countSubmissionsOfUser(int $user_id): int
    {
        return count(iterator_to_array(
            $this->getSubmissionsOfUser($user_id)
        ));
    }
 
    public function getSubmissionsOfUser(
        int $user_id,
        ?array $submit_ids = null,
        bool $only_valid = false,
        ?string $min_timestamp = null,
        bool $print_versions = false
    ): \Generator {
        $type_uses_print_versions = in_array($this->assignment->getType(), [
            \ilExAssignment::TYPE_BLOG,
            \ilExAssignment::TYPE_PORTFOLIO,
            \ilExAssignment::TYPE_WIKI_TEAM
        ], true);
        $type_uses_uploads = $this->type->usesFileUpload();
        if ($this->type->isSubmissionAssignedToTeam()) {
            $team_id = $this->team->getTeamForMember($this->ass_id, $user_id);
            if (((int) $team_id) !== 0) {
                yield from $this->repo->getSubmissionsOfTeam(
                    $this->ass_id,
                    $type_uses_uploads,
                    $type_uses_print_versions,
                    $team_id,
                    $submit_ids,
                    $only_valid,
                    $min_timestamp,
                    $print_versions
                );
            }
        } else {
            $user_ids = $this->team->getTeamMemberIdsOrUserId(
                $this->ass_id,
                $user_id
            );
            yield from $this->repo->getSubmissionsOfUsers(
                $this->ass_id,
                $type_uses_uploads,
                $type_uses_print_versions,
                $user_ids,
                $submit_ids,
                $only_valid,
                $min_timestamp,
                $print_versions
            );
        }
        yield from [];
    }
 
    public function getSubmissionsOfOwners(array $user_ids): \Generator
    {
        $type_uses_uploads = $this->type->usesFileUpload();
        $type_uses_print_versions = in_array($this->assignment->getType(), [
            \ilExAssignment::TYPE_BLOG,
            \ilExAssignment::TYPE_PORTFOLIO,
            \ilExAssignment::TYPE_WIKI_TEAM
        ], true);
        yield from $this->repo->getSubmissionsOfUsers(
            $this->ass_id,
            $type_uses_uploads,
            $type_uses_print_versions,
            $user_ids
        );
    }
 
    public function recalculateLateSubmissions(): void
    {
        // see JF, 2015-05-11
        $assigment = $this->assignment;
 
        $ext_deadline = $assigment->getExtendedDeadline();
 
        foreach ($this->getAllAssignmentFiles() as $file) {
            $id = $file["returned_id"];
            $uploaded = new \ilDateTime($file["ts"], IL_CAL_DATETIME);
            $uploaded = $uploaded->get(IL_CAL_UNIX);
 
            $deadline = $assigment->getPersonalDeadline($file["user_id"]);
            $last_deadline = max($deadline, $assigment->getExtendedDeadline());
 
            $late = null;
 
            // upload is not late anymore
            if ($file["late"] &&
                (!$last_deadline ||
                    !$ext_deadline ||
                    $uploaded < $deadline)) {
                $late = false;
            }
            // upload is now late
            elseif (!$file["late"] &&
                $ext_deadline &&
                $deadline &&
                $uploaded > $deadline) {
                $late = true;
            }
 
            if ($late !== null) {
                $this->repo->updateLate(
                    $id,
                    $late
                );
            }
        }
    }
 
    public function getAllAssignmentFiles(): array
    {
        $assignment = $this->assignment;
 
        $delivered = [];
        foreach ($this->repo->getAllEntriesOfAssignment($assignment->getId()) as $row) {
            $row["timestamp"] = $row["ts"];
            $delivered[] = $row;
        }
 
        return $delivered;
    }
 
    public function getMaxAmountOfSubmittedFiles(
        int $user_id = 0
    ): int {
        $ass = $this->assignment;
        return $this->repo->getMaxAmountOfSubmittedFiles(
            $ass->getExerciseId(),
            $ass->getId(),
            $user_id
        );
    }
 
    public function getUsersWithSubmission(): array
    {
        return $this->repo->getUsersWithSubmission(
            $this->ass_id
        );
    }
 
    public function addLocalFile(
        int $user_id,
        string $file,
        string $filename = ""
    ): bool {
 
        if ($filename === "") {
            $filename = basename($file);
        }
        $submission = new \ilExSubmission(
            $this->assignment,
            $user_id
        );
 
        if (!$submission->canAddFile()) {
            return false;
        }
 
        if ($this->type->isSubmissionAssignedToTeam()) {
            $team_id = $submission->getTeam()->getId();
            $user_id = 0;
            if ($team_id === 0) {
                return false;
            }
        } else {
            $team_id = 0;
        }
        $success = $this->repo->addLocalFile(
            $this->assignment->getExerciseId(),
            $this->ass_id,
            $user_id,
            $team_id,
            $file,
            $filename,
            $submission->isLate(),
            $this->stakeholder
        );
 
        if ($success && $team_id > 0) {
            $this->domain->team()->writeLog(
                $team_id,
                \ilExAssignmentTeam::TEAM_LOG_ADD_FILE,
                $filename
            );
        }
 
        return $success;
    }
 
    public function addUpload(
        int $user_id,
        UploadResult $result,
        string $filename = ""
    ): bool {
 
        if ($filename === "") {
            $filename = $result->getName();
        }
        $submission = new \ilExSubmission(
            $this->assignment,
            $user_id
        );
 
        if (!$submission->canAddFile()) {
            return false;
        }
 
        if ($this->type->isSubmissionAssignedToTeam()) {
            $team_id = $submission->getTeam()->getId();
            $user_id = 0;
            if ($team_id === 0) {
                return false;
            }
        } else {
            $team_id = 0;
        }
        $success = $this->repo->addUpload(
            $this->assignment->getExerciseId(),
            $this->ass_id,
            $user_id,
            $team_id,
            $result,
            $filename,
            $submission->isLate(),
            $this->stakeholder
        );
 
        if ($success && $team_id > 0) {
            $this->domain->team()->writeLog(
                $team_id,
                \ilExAssignmentTeam::TEAM_LOG_ADD_FILE,
                $filename
            );
        }
 
        return $success;
    }
 
    protected function remainingFilesAllowed(int $user_id): int
    {
        $submission = new \ilExSubmission(
            $this->assignment,
            $user_id
        );
        $max_file = $submission->getAssignment()->getMaxFile();
        if ($max_file === 0) {
            return -1;
        }
        $cnt_sub = $this->countSubmissionsOfUser($user_id);
        $max_file -= $cnt_sub;
        return max($max_file, 0);
    }
 
    public function addZipUploads(
        int $user_id,
        UploadResult $result
    ): bool {
        $submission = new \ilExSubmission(
            $this->assignment,
            $user_id
        );
        if (!$submission->canAddFile()) {
            return false;
        }
        if ($this->type->isSubmissionAssignedToTeam()) {
            $team_id = $submission->getTeam()->getId();
            $user_id = 0;
            if ($team_id === 0) {
                return false;
            }
        } else {
            $team_id = 0;
        }
        $filenames = $this->repo->addZipUpload(
            $this->assignment->getExerciseId(),
            $this->ass_id,
            $user_id,
            $team_id,
            $result,
            $submission->isLate(),
            $this->stakeholder,
            $this->remainingFilesAllowed($user_id)
        );
        $this->log->debug("99");
        if ($team_id > 0) {
            foreach ($filenames as $filename) {
                $this->domain->team()->writeLog(
                    $team_id,
                    \ilExAssignmentTeam::TEAM_LOG_ADD_FILE,
                    $filename
                );
            }
        }
 
        return count($filenames) > 0;
    }
 
    public function deliverFile(
        int $user_id,
        string $rid,
        string $filetitle = ""
    ): void {
        $this->repo->deliverFile(
            $this->ass_id,
            $user_id,
            $rid,
            $filetitle
        );
    }
 
    public function copyRidToWebDir(
        string $rid,
        string $internal_file_path
    ): ?string {
        global $DIC;
 
        $web_filesystem = $DIC->filesystem()->web();
 
        $internal_dirs = dirname($internal_file_path);
        $zip_file = basename($internal_file_path);
 
        if ($rid !== "") {
            //$this->log->debug("internal file path: " . $internal_file_path);
            if ($web_filesystem->hasDir($internal_dirs)) {
                $web_filesystem->deleteDir($internal_dirs);
            }
            $web_filesystem->createDir($internal_dirs);
            if ($web_filesystem->has($internal_file_path)) {
                $web_filesystem->delete($internal_file_path);
            }
            if (!$web_filesystem->has($internal_file_path)) {
                //$this->log->debug("writing: " . $internal_file_path);
                $stream = $this->repo->getStream(
                    $this->ass_id,
                    $rid
                );
                if (!is_null($stream)) {
                    $web_filesystem->writeStream($internal_file_path, $stream);
 
                    return ILIAS_ABSOLUTE_PATH .
                        DIRECTORY_SEPARATOR .
                        "public" .
                        DIRECTORY_SEPARATOR .
                        ILIAS_WEB_DIR .
                        DIRECTORY_SEPARATOR .
                        CLIENT_ID .
                        DIRECTORY_SEPARATOR .
                        $internal_dirs .
                        DIRECTORY_SEPARATOR .
                        $zip_file;
                }
            }
        }
 
        return null;
    }
 
    public function deleteSubmissions(int $user_id, array $ids): void
    {
        if (count($ids) == 0) {
            return;
        }
        $all = $this->getAllSubmissionIdsOfUser($user_id);
        foreach ($ids as $id) {
            // this ensures, the ids belong to user submissions at all
            if (!in_array($id, $all)) {
                continue;
            }
            $s = $this->repo->getById($id);
            $this->repo->delete(
                $id,
                $this->stakeholder
            );
            $team_id = $this->team->getTeamForMember($this->ass_id, $user_id);
            if ($team_id && $team_id > 0) {
                $this->team->writeLog(
                    $team_id,
                    \ilExAssignmentTeam::TEAM_LOG_REMOVE_FILE,
                    $s->getTitle()
                );
            }
        }
    }
 
    protected function getAllSubmissionIdsOfUser(int $user_id): array
    {
        $subs = [];
        foreach ($this->getSubmissionsOfUser($user_id) as $s) {
            $subs[] = $s->getId();
        }
        foreach ($this->getSubmissionsOfUser($user_id, null, false, null, true) as $s) {
            $subs[] = $s->getId();
        }
        return $subs;
    }
 
    public function deleteAllSubmissionsOfUser(int $user_id): void
    {
        $this->deleteSubmissions(
            $user_id,
            $this->getAllSubmissionIdsOfUser($user_id)
        );
    }
 
    public function copySubmissionsToDir(
        array $user_ids,
        string $directory
    ) {
        $members = [];
        foreach ($user_ids as $member_id) {
            $submission = new \ilExSubmission($this->assignment, $member_id);
            $submission->updateTutorDownloadTime();
 
            // get member object (ilObjUser)
            if ($this->domain->profile()->exists($member_id)) {
                // adding file metadata
                foreach ($this->getSubmissionsOfUser($member_id) as $sub) {
                    $members[$sub->getUserId()]["files"][$sub->getId()] = $sub;
                }
 
                $name = \ilObjUser::_lookupName($member_id);
                $members[$member_id]["name"] = $name["firstname"] . " " . $name["lastname"];
            }
        }
        $this->copySubmissionFilesToDir($members, $directory);
    }
 
    protected function copySubmissionFilesToDir(
        array $members,
        string $to_path
    ): void {
        global $DIC;
 
        $zip_archive = $DIC->archives()->zip([]);
        $ass = $this->assignment;
 
        $lng = $this->domain->lng();
        $log = $this->log;
 
 
        ksort($members);
        //$savepath = $storage->getAbsoluteSubmissionPath();
        //$cdir = getcwd();
 
        // important check: if the directory does not exist
        // ILIAS stays in the current directory (echoing only a warning)
        // and the zip command below archives the whole ILIAS directory
        // (including the data directory) and sends a mega file to the user :-o
        //        if (!is_dir($savepath)) {
        //            return;
        //        }
        // Safe mode fix
        //              chdir($this->getExercisePath());
 
        //        $tmpdir = $storage->getTempPath();
        //        chdir($tmpdir);
        //        $zip = PATH_TO_ZIP;
 
        //$ass_type = $a_ass->getType();
 
        // copy all member directories to the temporary folder
        // switch from id to member name and append the login if the member name is double
        // ensure that no illegal filenames will be created
        // remove timestamp from filename
        $team_map = null;
        $team_dirs = null;
        if ($ass->hasTeam()) {
            $team_dirs = array();
            $team_map = \ilExAssignmentTeam::getAssignmentTeamMap($ass->getId());
        }
        foreach ($members as $id => $item) {
            $user_files = $item["files"] ?? [];
 
            // group by teams
            $team_dir = "";
            if (is_array($team_map) &&
                array_key_exists($id, $team_map)) {
                $team_id = $team_map[$id];
                if (!array_key_exists($team_id, $team_dirs)) {
                    $team_dir = $lng->txt("exc_team") . " " . $team_id;
                    $team_dirs[$team_id] = $team_dir;
                }
                $team_dir = $team_dirs[$team_id] . DIRECTORY_SEPARATOR;
            }
 
            if ($ass->getAssignmentType()->isSubmissionAssignedToTeam()) {
                $targetdir = $team_dir . \ilFileUtils::getASCIIFilename(
                    $item["name"]
                );
                if ($targetdir == "") {
                    continue;
                }
            } else {
                $targetdir = $this->getDirectoryNameFromUserData($id);
                if ($ass->getAssignmentType()->usesTeams()) {
                    $targetdir = $team_dir . $targetdir;
                }
            }
 
            $log->debug("Creation target directory: " . $targetdir);
 
            $duplicates = [];
 
            foreach ($user_files as $sub) {
                $targetfile = $sub->getTitle();
 
                // rename repo objects
                if ($this->type->getSubmissionType() === \ilExSubmission::TYPE_REPO_OBJECT) {
                    $obj_id = \ilObject::_lookupObjId((int) $targetfile);
                    $obj_type = \ilObject::_lookupType($obj_id);
                    $targetfile = $obj_type . "_" . $obj_id . ".zip";
                }
 
                // handle duplicates
                if (array_key_exists($targetfile, $duplicates)) {
                    $suffix = strrpos($targetfile, ".");
                    $targetfile = substr($targetfile, 0, $suffix) .
                        " (" . (++$duplicates[$targetfile]) . ")" .
                        substr($targetfile, $suffix);
                } else {
                    $duplicates[$targetfile] = 1;
                }
 
                // add late submission info
                if ($sub->getLate()) {    // see #23900
                    $targetfile = $lng->txt("exc_late_submission") . " - " .
                        $targetfile;
                }
 
                // normalize and add directory
                $targetfile = \ilFileUtils::getASCIIFilename($targetfile);
                //$targetfile = $targetdir . DIRECTORY_SEPARATOR . $targetfile;
 
                /*
                $zip_archive->addStream(
                    $this->repo->getStream($ass->getId(), $sub->getRid()),
                    $targetfile
                );*/
 
                $stream = $this->repo->getStream($ass->getId(), $sub->getRid());
 
                // add file to directory (no zip see end of the function)
                $dir = $to_path . DIRECTORY_SEPARATOR . $targetdir;
                \ilFileUtils::makeDirParents($dir);
                $file = $dir . DIRECTORY_SEPARATOR . $targetfile;
                file_put_contents(
                    $file,
                    $stream->getContents()
                );
 
                // unzip blog/portfolio
 
            }
        }
    }
 
    protected function getDirectoryNameFromUserData(int $user_id): string
    {
        $userName = \ilObjUser::_lookupName($user_id);
        return \ilFileUtils::getASCIIFilename(
            trim($userName["lastname"]) . "_" .
            trim($userName["firstname"]) . "_" .
            trim($userName["login"]) . "_" .
            $userName["user_id"]
        );
    }
 
    public function deliverSubmissions(
        array $subs,
        int $user_id,
        bool $peer_review_mask_filename = false,
        int $peer_id = 0
    ): void {
        global $DIC;
 
        $filenames = array();
        $seq = 0;
        $is_team = $this->type->usesTeams() || $peer_review_mask_filename;
        foreach ($subs as $sub) {
            if ($this->type->isSubmissionAssignedToTeam()) {
                $storage_id = $sub->getTeamId();
            } else {
                $storage_id = $sub->getUserId();
            }
 
            $src = $sub->getTitle();
            if ($peer_review_mask_filename) {
                $src_a = explode(".", $src);
                $suffix = array_pop($src_a);
                $tgt = $this->assignment->getTitle() . "_peer" . $peer_id .
                    "_" . (++$seq) . "." . $suffix;
 
                $filenames[$storage_id][] = array(
                    "src" => $src,
                    "tgt" => $tgt,
                    "rid" => $sub->getRid()
                );
            } else {
                $filenames[$storage_id][] = array(
                    "src" => $src,
                    "late" => $sub->getLate(),
                    "rid" => $sub->getRid()
                );
            }
        }
 
        if ($is_team) {
            $multi_user = true;
            $user_id = null;
        } else {
            $multi_user = false;
        }
 
        $lng = $this->domain->lng();
 
        $zip = $DIC->archives()->zip([]);
 
 
        $assTitle = \ilExAssignment::lookupTitle($this->assignment->getId());
        $deliverFilename = str_replace(" ", "_", $assTitle);
        if ($user_id > 0 && !$multi_user) {
            $userName = \ilObjUser::_lookupName($user_id);
            $deliverFilename .= "_" . $userName["lastname"] . "_" . $userName["firstname"];
        } else {
            $deliverFilename .= "_files";
        }
        $orgDeliverFilename = trim($deliverFilename);
        $deliverFilename = \ilFileUtils::getASCIIFilename($orgDeliverFilename);
 
        //copy all files to a temporary directory and remove them afterwards
        $parsed_files = $duplicates = array();
        foreach ($filenames as $files) {
 
            foreach ($files as $file) {
                // peer review masked filenames, see deliverReturnedFiles()
                if (isset($file["tgt"])) {
                    $newFilename = $file["tgt"];
                    $filename = $file["src"];
                } else {
                    $late = $file["late"];
                    $filename = $file["src"];
 
                    // remove timestamp
                    $newFilename = trim($filename);
                    $pos = strpos($newFilename, "_");
                    if ($pos !== false) {
                        $newFilename = substr($newFilename, $pos + 1);
                    }
                    // #11070
                    $chkName = strtolower($newFilename);
                    if (array_key_exists($chkName, $duplicates)) {
                        $suffix = strrpos($newFilename, ".");
                        $newFilename = substr($newFilename, 0, $suffix) .
                            " (" . (++$duplicates[$chkName]) . ")" .
                            substr($newFilename, $suffix);
                    } else {
                        $duplicates[$chkName] = 1;
                    }
 
                    if ($late) {
                        $newFilename = $lng->txt("exc_late_submission") . " - " .
                            $newFilename;
                    }
                }
 
                $newFilename = \ilFileUtils::getASCIIFilename($newFilename);
                $newFilename = $deliverFilename . DIRECTORY_SEPARATOR . $newFilename;
                $zip->addStream(
                    $this->repo->getStream(
                        $this->ass_id,
                        $file["rid"]
                    ),
                    $newFilename
                );
 
                /*
                $parsed_files[] = ilShellUtil::escapeShellArg(
                    $deliverFilename . DIRECTORY_SEPARATOR . basename($newFilename)
                );*/
            }
        }
 
        // todo: move to gui
        $http_util = $DIC->exercise()->internal()->gui()->httpUtil();
        $http_util->deliverStream(
            $zip->get(),
            $orgDeliverFilename . ".zip",
            "application/zip"
        );
    }
 
}