Class ilObjFileAbstractZipProcessor. More...

Inheritance diagram for ilObjFileAbstractZipProcessor:

Collaboration diagram for ilObjFileAbstractZipProcessor:

Public Member Functions
	__construct (ResourceStakeholder $stakeholder, ilObjFileGUI $gui_object, Services $storage, ilFileServicesSettings $settings, $tree)

Public Member Functions inherited from ilObjFileAbstractProcessor
	__construct (ResourceStakeholder $stakeholder, ilObjFileGUI $gui_object, Services $storage, ilFileServicesSettings $settings)

	getInvalidFileNames ()

Public Member Functions inherited from ilObjFileProcessorInterface
	process (ResourceIdentification $rid, array $options=[])
	Processes a given resource for the given arguments. More...

Protected Member Functions
	createSurroundingContainer (ResourceIdentification $rid)

	createContainerObj (string $dir_name, int $parent_id, array $options=[])
	Creates a container object depending on the parent's node type and returns it. More...

	openZip (ResourceIdentification $rid)
	Opens the zip archive of the given resource. More...

	getZipFiles ()
	Yields the file-paths of the currently open zip-archive. More...

	hasMultipleRootEntriesInZip ()

	getZipDirectories ()
	Yields the directory-paths of the currently open zip-archive. More...

	storeZippedFile (string $file_path)
	Creates an IRSS resource from the given filepath. More...

	closeZip ()
	Closes the currently open zip-archive. More...

	isWorkspace ()
	Returns whether the current context is workspace. More...

Protected Member Functions inherited from ilObjFileAbstractProcessor
	createFileObj (ResourceIdentification $rid, int $parent_id, array $options=[], bool $create_reference=false)
	Creates an ilObjFile instance for the provided information. More...

	applyOptions (ilObject $obj, array $options)
	Apply provided options to the given object. More...

Protected Attributes
bool	$create_base_container_for_multiple_root_entries = false
	Unzip on operating systems may behave differently when unzipping if there are only one or more root nodes in the zip. More...

Protected Attributes inherited from ilObjFileAbstractProcessor
ilFileServicesPolicy	$policy

ilFileServicesSettings	$settings

ilCountPDFPages	$page_counter

Services	$storage

ResourceStakeholder	$stakeholder

ilObjFileGUI	$gui_object

array	$invalid_file_names = []

Private Member Functions
	getZipPaths ()
	Yields all paths of the currently open zip-archive (without some macos stuff). More...

	getPossibleContainerObj (int $parent_id)
	Returns a container object that is possible for the given parent. More...

Private Attributes
const	IRSS_FILEPATH_KEY = 'uri'

	$tree

ZipArchive	$archive = null

int	$id_type

Additional Inherited Members
Data Fields inherited from ilObjFileProcessorInterface
const	OPTION_FILENAME = 'title'

const	OPTION_DESCRIPTION = 'description'

const	OPTIONS

Detailed Description

Class ilObjFileAbstractZipProcessor.

Author: Thibeau Fuhrer thf@s.nosp@m.tude.nosp@m.r-rai.nosp@m.mann.nosp@m..ch

Definition at line 29 of file class.ilObjFileAbstractZipProcessor.php.

Constructor & Destructor Documentation

◆ __construct()

ilObjFileAbstractZipProcessor::__construct	(	ResourceStakeholder	$stakeholder,
		ilObjFileGUI	$gui_object,
		Services	$storage,
		ilFileServicesSettings	$settings,
			$tree
	)

Parameters

ilTree | ilWorkspaceTree $tree

Definition at line 56 of file class.ilObjFileAbstractZipProcessor.php.

References $tree, ILIAS\GlobalScreen\Provider\__construct(), and ilObject2GUI\getIdType().

       {
         parent::__construct($stakeholder, $gui_object, $storage, $settings);
 
         $this->id_type = $gui_object->getIdType();
         $this->tree = $tree;
     }

Here is the call graph for this function:

Member Function Documentation

◆ closeZip()

ilObjFileAbstractZipProcessor::closeZip ( )

protected

Closes the currently open zip-archive.

Definition at line 220 of file class.ilObjFileAbstractZipProcessor.php.

Referenced by ilObjFileUnzipFlatProcessor\process(), and ilObjFileUnzipRecursiveProcessor\process().

                                  : void
     {
         if ($this->archive !== null) {
             $this->archive->close();
         }
     }

Here is the caller graph for this function:

◆ createContainerObj()

ilObjFileAbstractZipProcessor::createContainerObj	(	string	$dir_name,
		int	$parent_id,
		array	$options = `[]`
	)

protected

Creates a container object depending on the parent's node type and returns it.

Definition at line 83 of file class.ilObjFileAbstractZipProcessor.php.

References ilObjFileAbstractProcessor\applyOptions(), and getPossibleContainerObj().

Referenced by createSurroundingContainer(), and ilObjFileUnzipRecursiveProcessor\process().

                                                                                                 : ilObject
     {
         $container_obj = $this->getPossibleContainerObj($parent_id);
         $container_obj->setTitle($dir_name);
 
         if (!empty($options)) {
             $this->applyOptions($container_obj, $options);
         }
 
         $container_obj->create();
         $container_obj->createReference();
 
         $this->gui_object->putObjectInTree($container_obj, $parent_id);
 
         return $container_obj;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createSurroundingContainer()

ilObjFileAbstractZipProcessor::createSurroundingContainer ( ResourceIdentification $rid )

protected

Definition at line 69 of file class.ilObjFileAbstractZipProcessor.php.

References createContainerObj().

Referenced by ilObjFileUnzipFlatProcessor\process(), and ilObjFileUnzipRecursiveProcessor\process().

                                                                               : int
     {
         // create one base container with the name of the zip itself, all other containers will be created inside this one
         $zip_name = $this->storage->manage()->getCurrentRevision($rid)->getInformation()->getTitle();
         $info = new SplFileInfo($zip_name);
         $base_path = $info->getBasename("." . $info->getExtension());
         $base_container = $this->createContainerObj($base_path, $this->gui_object->getParentId());
 
         return (int) $base_container->getRefId();
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPossibleContainerObj()

ilObjFileAbstractZipProcessor::getPossibleContainerObj ( int $parent_id )

private

Returns a container object that is possible for the given parent.

Parameters

int $parent_id

Returns: ilObject

Definition at line 241 of file class.ilObjFileAbstractZipProcessor.php.

References $type, ilObject\_lookupType(), and isWorkspace().

Referenced by createContainerObj().

                                                             : ilObject
     {
         $type = ($this->isWorkspace()) ?
             ilObject::_lookupType($this->tree->lookupObjectId($parent_id)) :
             ilObject::_lookupType($parent_id, true)
         ;
 
         switch ($type) {
             case 'wfld':
             case 'wsrt':
                 return new ilObjWorkspaceFolder();
 
             case 'cat':
             case 'root':
                 return new ilObjCategory();
 
             case 'fold':
             case 'crs':
 
             default:
                 return new ilObjFolder();
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getZipDirectories()

ilObjFileAbstractZipProcessor::getZipDirectories ( )

protected

Yields the directory-paths of the currently open zip-archive.

This fixes the issue that win and mac zip archives have different directory structures.

Returns: Generator|string[]

Definition at line 176 of file class.ilObjFileAbstractZipProcessor.php.

References $path, and getZipPaths().

Referenced by hasMultipleRootEntriesInZip(), and ilObjFileUnzipRecursiveProcessor\process().

                                           : Generator
     {
         $directories = [];
         foreach ($this->getZipPaths() as $path) {
             if (substr($path, -1) === "/" || substr($path, -1) === "\\") {
                 $directories[] = $path;
             }
         }
 
         $directories_with_parents = [];
 
         foreach ($directories as $directory) {
             $parent = dirname($directory) . '/';
             if ($parent !== './' && !in_array($parent, $directories)) {
                 $directories_with_parents[] = $parent;
             }
             $directories_with_parents[] = $directory;
         }
 
         $directories_with_parents = array_unique($directories_with_parents);
         sort($directories_with_parents);
         yield from $directories_with_parents;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getZipFiles()

ilObjFileAbstractZipProcessor::getZipFiles ( )

protected

Yields the file-paths of the currently open zip-archive.

Returns: Generator|string[]

Definition at line 138 of file class.ilObjFileAbstractZipProcessor.php.

References $path, and getZipPaths().

Referenced by hasMultipleRootEntriesInZip(), ilObjFileUnzipFlatProcessor\process(), and ilObjFileUnzipRecursiveProcessor\process().

                                     : Generator
     {
         foreach ($this->getZipPaths() as $path) {
             if (substr($path, -1) !== "/" && substr($path, -1) !== "\\") {
                 yield $path;
             }
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getZipPaths()

ilObjFileAbstractZipProcessor::getZipPaths ( )

private

Yields all paths of the currently open zip-archive (without some macos stuff).

Returns: Generator|string[]

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

References $i, and $path.

Referenced by getZipDirectories(), and getZipFiles().

                                   : Generator
     {
         if (null === $this->archive) {
             throw new LogicException("cannot read content of unopened zip archive");
         }
 
         for ($i = 0, $i_max = $this->archive->count(); $i < $i_max; $i++) {
             $path = $this->archive->getNameIndex($i, ZipArchive::FL_UNCHANGED);
             if (strpos($path, '__MACOSX') !== false || strpos($path, '.DS_') !== false) {
                 continue;
             }
 
             yield $path;
         }
     }

Here is the caller graph for this function:

◆ hasMultipleRootEntriesInZip()

ilObjFileAbstractZipProcessor::hasMultipleRootEntriesInZip ( )

protected

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

References getZipDirectories(), and getZipFiles().

Referenced by ilObjFileUnzipRecursiveProcessor\process().

                                                     : bool
     {
         $amount = 0;
         foreach ($this->getZipDirectories() as $zip_directory) {
             $dirname = dirname($zip_directory);
             if ($dirname === '.') {
                 $amount++;
             }
             if ($amount > 1) {
                 return true;
             }
         }
         foreach ($this->getZipFiles() as $zip_file) {
             $dirname = dirname($zip_file);
             if ($dirname === '.') {
                 $amount++;
             }
             if ($amount > 1) {
                 return true;
             }
         }
         return false;
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ isWorkspace()

ilObjFileAbstractZipProcessor::isWorkspace ( )

protected

Returns whether the current context is workspace.

Definition at line 230 of file class.ilObjFileAbstractZipProcessor.php.

References ilObject2GUI\WORKSPACE_NODE_ID.

Referenced by getPossibleContainerObj().

                                     : bool
     {
         return (ilObject2GUI::WORKSPACE_NODE_ID === $this->id_type);
     }

Here is the caller graph for this function:

◆ openZip()

ilObjFileAbstractZipProcessor::openZip ( ResourceIdentification $rid )

protected

Opens the zip archive of the given resource.

Definition at line 103 of file class.ilObjFileAbstractZipProcessor.php.

Referenced by ilObjFileUnzipFlatProcessor\process(), and ilObjFileUnzipRecursiveProcessor\process().

                                                            : void
     {
         if (null !== $this->archive) {
             throw new LogicException("openZip() can only be called once, yet it was called again.");
         }
 
         $file_uri = $this->storage->consume()->stream($rid)->getStream()->getMetadata(self::IRSS_FILEPATH_KEY);
         $this->archive = new ZipArchive();
         $this->archive->open($file_uri);
     }

Here is the caller graph for this function:

◆ storeZippedFile()

ilObjFileAbstractZipProcessor::storeZippedFile ( string $file_path )

protected

Creates an IRSS resource from the given filepath.

Definition at line 204 of file class.ilObjFileAbstractZipProcessor.php.

Referenced by ilObjFileUnzipFlatProcessor\process(), and ilObjFileUnzipRecursiveProcessor\process().

                                                          : ResourceIdentification
     {
         if (null === $this->archive) {
             throw new LogicException("No archive has been opened yet, call openZip() first in order to read files.");
         }
 
         return $this->storage->manage()->stream(
             Streams::ofString($this->archive->getFromName($file_path)),
             $this->stakeholder,
             basename($file_path)
         );
     }

Here is the caller graph for this function:

Field Documentation

◆ $archive

ZipArchive ilObjFileAbstractZipProcessor::$archive = null

private

Definition at line 41 of file class.ilObjFileAbstractZipProcessor.php.

◆ $create_base_container_for_multiple_root_entries

bool ilObjFileAbstractZipProcessor::$create_base_container_for_multiple_root_entries = false

protected

Unzip on operating systems may behave differently when unzipping if there are only one or more root nodes in the zip.

Currently, the behavior is the same as in ILIAS 7 and earlier, that in any case the zip structure is checked out directly at the current location in the magazine. If this value is set to true here, another category/folder will be placed around the files and folders of the zip when unpacking if more than one root-node is present. For example, macOS behaves in exactly this way.

Definition at line 51 of file class.ilObjFileAbstractZipProcessor.php.

◆ $id_type

int ilObjFileAbstractZipProcessor::$id_type

private

Definition at line 42 of file class.ilObjFileAbstractZipProcessor.php.

◆ $tree

ilObjFileAbstractZipProcessor::$tree

private

Definition at line 39 of file class.ilObjFileAbstractZipProcessor.php.

Referenced by __construct().

◆ IRSS_FILEPATH_KEY

const ilObjFileAbstractZipProcessor::IRSS_FILEPATH_KEY = 'uri'

private

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

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

Modules/File/classes/Processors/class.ilObjFileAbstractZipProcessor.php

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ closeZip()

◆ createContainerObj()

◆ createSurroundingContainer()

◆ getPossibleContainerObj()

◆ getZipDirectories()

◆ getZipFiles()

◆ getZipPaths()

◆ hasMultipleRootEntriesInZip()

◆ isWorkspace()

◆ openZip()

◆ storeZippedFile()

Field Documentation

◆ $archive

◆ $create_base_container_for_multiple_root_entries

◆ $id_type

◆ $tree

◆ IRSS_FILEPATH_KEY