ilCertificateTemplateImportAction Class Reference

Collaboration diagram for ilCertificateTemplateImportAction:

Public Member Functions
	__construct (private readonly int $objectId, private readonly string $certificatePath, private readonly ilCertificatePlaceholderDescription $placeholderDescriptionObject, private readonly ilLogger $logger, private readonly Filesystem $filesystem, private readonly IRSS $irss, ?ilCertificateTemplateRepository $templateRepository=null, ?ilCertificateObjectHelper $objectHelper=null, ?ilCertificateUtilHelper $utilHelper=null, ?ilDBInterface $database=null,)
	import (string $zipFile, string $filename, string $rootDir=CLIENT_WEB_DIR, string $iliasVersion=ILIAS_VERSION_NUMERIC, string $installationID=IL_INST_ID)

Private Member Functions
	createArchiveDirectory (string $installationID)
	Creates a directory for a zip archive containing multiple certificates. More...

Private Attributes
readonly ilCertificateTemplateRepository	$templateRepository
readonly ilCertificateObjectHelper	$objectHelper
readonly ilCertificateUtilHelper	$utilHelper
readonly ilCertificateTemplateStakeholder	$stakeholder

Detailed Description

Author

Niels Theen nthee.nosp@m.n@da.nosp@m.tabay.nosp@m..de

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

Constructor & Destructor Documentation

__construct()

ilCertificateTemplateImportAction::__construct	(	private readonly int	$objectId,
		private readonly string	$certificatePath,
		private readonly ilCertificatePlaceholderDescription	$placeholderDescriptionObject,
		private readonly ilLogger	$logger,
		private readonly Filesystem	$filesystem,
		private readonly IRSS	$irss,
		?ilCertificateTemplateRepository	$templateRepository = null,
		?ilCertificateObjectHelper	$objectHelper = null,
		?ilCertificateUtilHelper	$utilHelper = null,
		?ilDBInterface	$database = null
	)

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

References $DIC, $objectHelper, $templateRepository, $utilHelper, and null.

      {
        global $DIC;
        if (null === $database) {
            $database = $DIC->database();
        }

        if (null === $templateRepository) {
            $templateRepository = new ilCertificateTemplateDatabaseRepository($database, $logger);
        }
        $this->templateRepository = $templateRepository;

        if (null === $objectHelper) {
            $objectHelper = new ilCertificateObjectHelper();
        }
        $this->objectHelper = $objectHelper;

        if (null === $utilHelper) {
            $utilHelper = new ilCertificateUtilHelper();
        }
        $this->utilHelper = $utilHelper;
        $this->stakeholder = new ilCertificateTemplateStakeholder();
    }

Member Function Documentation

createArchiveDirectory()

ilCertificateTemplateImportAction::createArchiveDirectory ( string  $installationID )

private

Creates a directory for a zip archive containing multiple certificates.

Returns

string The created archive directory

Exceptions

IOException

Definition at line 213 of file class.ilCertificateTemplateImportAction.php.

References ILIAS\Repository\filesystem().

Referenced by import().

                                                                   : string
    {
        $type = $this->objectHelper->lookupType($this->objectId);
        $certificateId = $this->objectId;

        $dir = $this->certificatePath . time() . '__' . $installationID . '__' . $type . '__' . $certificateId . '__certificate/';
        if ($this->filesystem->hasDir($dir)) {
            $this->filesystem->deleteDir($dir);
        }
        $this->filesystem->createDir($dir);

        return $dir;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

import()

ilCertificateTemplateImportAction::import	(	string	$zipFile,
		string	$filename,
		string	$rootDir = CLIENT_WEB_DIR,
		string	$iliasVersion = ILIAS_VERSION_NUMERIC,
		string	$installationID = IL_INST_ID
	)

Exceptions

FileAlreadyExistsException
FileNotFoundException
IOException
ilDatabaseException
ilException

Definition at line 79 of file class.ilCertificateTemplateImportAction.php.

References Vendor\Package\$e, createArchiveDirectory(), ILIAS\Repository\filesystem(), and ILIAS\Repository\logger().

     : bool {
        $importPath = $this->createArchiveDirectory($installationID);

        $clean_up_import_dir = function () use (&$importPath) {
            try {
                if ($this->filesystem->hasDir($importPath)) {
                    $this->filesystem->deleteDir($importPath);
                }
            } catch (Throwable $e) {
                $this->logger->error(sprintf("Can't clean up import directory: %s", $e->getMessage()));
                $this->logger->error($e->getTraceAsString());
            }
        };

        $result = $this->utilHelper->moveUploadedFile($zipFile, $filename, $rootDir . $importPath . $filename);
        if (!$result) {
            $clean_up_import_dir();

            return false;
        }

        $destination_dir = $rootDir . $importPath;
        $unzip = $this->utilHelper->unzip(
            $rootDir . $importPath . $filename,
            $destination_dir,
            true
        );

        $unzipped = $unzip->extract();

        // Cleanup memory, otherwise there will be issues with NFS-based file systems after `listContents` has been called
        unset($unzip);

        if (!$unzipped) {
            $clean_up_import_dir();

            return false;
        }

        if ($this->filesystem->has($importPath . $filename)) {
            $this->filesystem->delete($importPath . $filename);
        }

        $xmlFiles = 0;
        $contents = $this->filesystem->listContents($importPath);
        foreach ($contents as $file) {
            if ($file->isFile() && str_contains($file->getPath(), '.xml')) {
                $xmlFiles++;
            }
        }

        if (0 === $xmlFiles) {
            return false;
        }

        $certificate = $this->templateRepository->fetchCurrentlyUsedCertificate($this->objectId);

        $currentVersion = $certificate->getVersion();
        $newVersion = $currentVersion + 1;
        $xsl = $certificate->getCertificateContent();

        foreach ($contents as $file) {
            if (!$file->isFile()) {
                continue;
            }

            if (str_contains($file->getPath(), '.xml')) {
                $xsl = $this->filesystem->read($file->getPath());
            } elseif (str_contains($file->getPath(), '.jpg')) {
                $background_rid = $this->irss->manage()->stream(
                    $this->filesystem->readStream($file->getPath()),
                    $this->stakeholder
                );
            } elseif (str_contains($file->getPath(), '.svg')) {
                $tile_image_rid = $this->irss->manage()->stream(
                    $this->filesystem->readStream($file->getPath()),
                    $this->stakeholder
                );
            }
        }

        $jsonEncodedTemplateValues = json_encode(
            $this->placeholderDescriptionObject->getPlaceholderDescriptions(),
            JSON_THROW_ON_ERROR
        );

        $newHashValue = hash(
            'sha256',
            implode('', [
                $xsl,
                isset($background_rid) ? $this->irss->manage()->getResource(
                    $background_rid
                )->getStorageID() : '',
                $jsonEncodedTemplateValues,
                isset($tile_image_rid) ? $this->irss->manage()->getResource(
                    $tile_image_rid
                )->getStorageID() : ''
            ])
        );

        $template = new ilCertificateTemplate(
            $this->objectId,
            $this->objectHelper->lookupType($this->objectId),
            $xsl,
            $newHashValue,
            $jsonEncodedTemplateValues,
            $newVersion,
            $iliasVersion,
            time(),
            false,
            '',
            '',
            isset($background_rid) ? $background_rid->serialize() : '',
            isset($tile_image_rid) ? $tile_image_rid->serialize() : ''
        );

        $this->templateRepository->save($template);

        $clean_up_import_dir();

        return true;
    }

Here is the call graph for this function:

Field Documentation

$objectHelper

readonly ilCertificateObjectHelper ilCertificateTemplateImportAction::$objectHelper

private

Definition at line 34 of file class.ilCertificateTemplateImportAction.php.

Referenced by __construct().

$stakeholder

readonly ilCertificateTemplateStakeholder ilCertificateTemplateImportAction::$stakeholder

private

Definition at line 36 of file class.ilCertificateTemplateImportAction.php.

$templateRepository

readonly ilCertificateTemplateRepository ilCertificateTemplateImportAction::$templateRepository

private

Definition at line 33 of file class.ilCertificateTemplateImportAction.php.

Referenced by __construct().

$utilHelper

readonly ilCertificateUtilHelper ilCertificateTemplateImportAction::$utilHelper

private

Definition at line 35 of file class.ilCertificateTemplateImportAction.php.

Referenced by __construct().

---

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

• components/ILIAS/Certificate/classes/Template/Action/Import/class.ilCertificateTemplateImportAction.php