Inheritance diagram for ilFileSystemAbstractionStorage:

Collaboration diagram for ilFileSystemAbstractionStorage:

Public Member Functions
	__construct (int $a_storage_type, bool $a_path_conversion, int $a_container_id)
	Constructor. More...

	fileExists (string $a_absolute_path)

	getContainerId ()

	writeToFile (string $a_data, $a_absolute_path)

	copyFile (string $a_from, string $a_to)

	create ()

	getAbsolutePath ()
	Calculates the full path on the filesystem. More...

	delete ()

	deleteDirectory (string $a_abs_name)

	deleteFile (string $a_abs_name)

	appendToPath (string $a_appendix)

	getStorageType ()

	getPath ()

Static Public Member Functions
static	createPathFromId (int $a_container_id, string $a_name)

static	_copyDirectory (string $a_sdir, string $a_tdir)

Data Fields
const	STORAGE_WEB = 1

const	STORAGE_DATA = 2

const	STORAGE_SECURED = 3

Protected Member Functions
	getLegacyFullAbsolutePath (string $relative_path)

	getFileSystemService ()

	getPathPrefix ()
	Get path prefix. More...

	getPathPostfix ()
	Get directory name. More...

	getLegacyAbsolutePath ()
	Calculates the absolute filesystem storage location. More...

	init ()

Protected Attributes
string	$path = null

ILIAS Filesystem Filesystems	$file_system_service

Private Member Functions
	createRelativePathForFileSystem (string $a_absolute_path)

Private Attributes
const	FACTOR = 100

const	MAX_EXPONENT = 3

const	SECURED_DIRECTORY = "sec"

int	$container_id

int	$storage_type

bool	$path_conversion = false

Detailed Description

Deprecated:

Definition at line 26 of file class.ilFileSystemAbstractionStorage.php.

Constructor & Destructor Documentation

◆ __construct()

ilFileSystemAbstractionStorage::__construct	(	int	$a_storage_type,
		bool	$a_path_conversion,
		int	$a_container_id
	)

Constructor.

Parameters

$a_storage_type	int storage type
$a_path_conversion	bool En/Disable automatic path conversion. If enabled files with id 123 will be stored in directory files/1/file_123 object id of container
$a_container_id	int (e.g file_id or mob_id)

Definition at line 50 of file class.ilFileSystemAbstractionStorage.php.

    {
        global $DIC;
        $this->storage_type = $a_storage_type;
        $this->path_conversion = $a_path_conversion;
        $this->container_id = $a_container_id;
        $this->file_system_service = $DIC->filesystem();
 
        // Get path info
        $this->init();
    }

References $DIC, and init().

Here is the call graph for this function:

Member Function Documentation

◆ _copyDirectory()

static ilFileSystemAbstractionStorage::_copyDirectory	(	string	$a_sdir,
		string	$a_tdir
	)

static

Definition at line 243 of file class.ilFileSystemAbstractionStorage.php.

                                                                         : bool
    {
        try {
            $sourceFS = LegacyPathHelper::deriveFilesystemFrom($a_sdir);
            $targetFS = LegacyPathHelper::deriveFilesystemFrom($a_tdir);
 
            $sourceDir = LegacyPathHelper::createRelativePath($a_sdir);
            $targetDir = LegacyPathHelper::createRelativePath($a_tdir);
 
            // check if arguments are directories
            if (!$sourceFS->hasDir($sourceDir)) {
                return false;
            }
 
            $sourceList = $sourceFS->listContents($sourceDir, true);
 
            foreach ($sourceList as $item) {
                if ($item->isDir()) {
                    continue;
                }
 
                $itemPath = $targetDir . '/' . substr($item->getPath(), strlen($sourceDir));
                $stream = $sourceFS->readStream($sourceDir);
                $targetFS->writeStream($itemPath, $stream);
            }
 
            return true;
        } catch (\Exception $exception) {
            return false;
        }
    }

Referenced by ilFSStorageCourse\_clone().

Here is the caller graph for this function:

◆ appendToPath()

ilFileSystemAbstractionStorage::appendToPath ( string $a_appendix )

Definition at line 275 of file class.ilFileSystemAbstractionStorage.php.

                                                    : void
    {
        $this->path .= $a_appendix;
    }

Referenced by ilFSStorageMail\__construct().

Here is the caller graph for this function:

◆ copyFile()

ilFileSystemAbstractionStorage::copyFile	(	string	$a_from,
		string	$a_to
	)

Deprecated:: Please use StorageService or FilesystemService for all file opertion

Definition at line 133 of file class.ilFileSystemAbstractionStorage.php.

                                                          : bool
    {
        if (@file_exists($a_from)) {
            @copy($a_from, $a_to);
            return true;
        }
        return false;
    }

◆ create()

ilFileSystemAbstractionStorage::create ( )

Reimplemented in ilFSStorageExercise, ilIndividualAssessmentFileStorage, ilTestProcessLockFileStorage, and ilAssQuestionProcessLockFileStorage.

Definition at line 155 of file class.ilFileSystemAbstractionStorage.php.

                            : void
    {
        if (!$this->getFileSystemService()->has($this->path)) {
            $this->getFileSystemService()->createDir($this->path);
        }
    }

References getFileSystemService(), and ILIAS\GlobalScreen\has().

Referenced by ilLearningSequenceFilesystem\__construct(), and ilRestFileStorage\init().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createPathFromId()

static ilFileSystemAbstractionStorage::createPathFromId	(	int	$a_container_id,
		string	$a_name
	)

static

Definition at line 92 of file class.ilFileSystemAbstractionStorage.php.

                                                                                : string
    {
        $path = [];
        $found = false;
        $num = $a_container_id;
        $path_string = '';
        for ($i = self::MAX_EXPONENT; $i > 0; $i--) {
            $factor = pow(self::FACTOR, $i);
            if (($tmp = (int) ($num / $factor)) or $found) {
                $path[] = $tmp;
                $num = $num % $factor;
                $found = true;
            }
        }
 
        if (count($path)) {
            $path_string = (implode('/', $path) . '/');
        }
 
        return $path_string . $a_name . '_' . $a_container_id;
    }

References $i, and $path.

Referenced by init().

Here is the caller graph for this function:

◆ createRelativePathForFileSystem()

ilFileSystemAbstractionStorage::createRelativePathForFileSystem ( string $a_absolute_path )

private

Definition at line 290 of file class.ilFileSystemAbstractionStorage.php.

                                                                             : string
    {
        $relative_path = ILIAS\Filesystem\Util\LegacyPathHelper::createRelativePath($a_absolute_path);
 
        return $relative_path;
    }

References ILIAS\Filesystem\Util\LegacyPathHelper\createRelativePath().

Referenced by deleteDirectory(), deleteFile(), and fileExists().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ delete()

ilFileSystemAbstractionStorage::delete ( )

Definition at line 218 of file class.ilFileSystemAbstractionStorage.php.

                            : bool
    {
        try {
            $this->getFileSystemService()->deleteDir($this->getAbsolutePath());
        } catch (Exception $e) {
            return false;
        }
 
        return true;
    }

References Vendor\Package\$e, getAbsolutePath(), and getFileSystemService().

Here is the call graph for this function:

◆ deleteDirectory()

ilFileSystemAbstractionStorage::deleteDirectory ( string $a_abs_name )

Definition at line 229 of file class.ilFileSystemAbstractionStorage.php.

                                                       : bool
    {
        $path = $this->createRelativePathForFileSystem($a_abs_name);
        $this->getFileSystemService()->deleteDir($path);
        return !$this->getFileSystemService()->has($path);
    }

References $path, createRelativePathForFileSystem(), and getFileSystemService().

Here is the call graph for this function:

◆ deleteFile()

ilFileSystemAbstractionStorage::deleteFile ( string $a_abs_name )

Definition at line 236 of file class.ilFileSystemAbstractionStorage.php.

                                                  : bool
    {
        $path = $this->createRelativePathForFileSystem($a_abs_name);
        $this->getFileSystemService()->delete($path);
        return !$this->getFileSystemService()->has($path);
    }

References $path, createRelativePathForFileSystem(), and getFileSystemService().

Referenced by ilIndividualAssessmentFileStorage\deleteAllFilesBut(), ilFSStorageCourse\deleteMemberExportFile(), and ilFSStorageGroup\deleteMemberExportFile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ fileExists()

ilFileSystemAbstractionStorage::fileExists ( string $a_absolute_path )

Definition at line 62 of file class.ilFileSystemAbstractionStorage.php.

                                                       : bool
    {
        return $this->getFileSystemService()->has($this->createRelativePathForFileSystem($a_absolute_path));
    }

References createRelativePathForFileSystem(), and getFileSystemService().

Referenced by ilFSStorageCourse\hasMemberExportFile(), and ilFSStorageGroup\hasMemberExportFile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getAbsolutePath()

ilFileSystemAbstractionStorage::getAbsolutePath ( )

Calculates the full path on the filesystem.

This method is filesystem aware and will create the absolute path if it's not already existing.

Returns: string Absolute filesystem path.

Exceptions

IOException Thrown if the absolute path could not be created.

Reimplemented in ilIndividualAssessmentFileStorage.

Definition at line 171 of file class.ilFileSystemAbstractionStorage.php.

                                     : string
    {
        return rtrim($this->getLegacyAbsolutePath(), "/");
    }

References getLegacyAbsolutePath().

Referenced by ilLearningSequenceFilesystem\__construct(), ilFSStorageSession\createDirectory(), delete(), ilFSStorageCourse\getInfoDirectory(), ilFSStorageCourse\getMemberExportDirectory(), ilFSStorageGroup\getMemberExportDirectory(), ilFSStorageMail\getRelativePathExMailDirectory(), and ilFSStorageExercise\init().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getContainerId()

ilFileSystemAbstractionStorage::getContainerId ( )

Definition at line 87 of file class.ilFileSystemAbstractionStorage.php.

                                    : int
    {
        return $this->container_id;
    }

References $container_id.

Referenced by ilFSStorageCourse\getMemberExportFiles(), and ilFSStorageGroup\getMemberExportFiles().

Here is the caller graph for this function:

◆ getFileSystemService()

ilFileSystemAbstractionStorage::getFileSystemService ( )

protected

Definition at line 74 of file class.ilFileSystemAbstractionStorage.php.

                                             : Filesystem
    {
        switch ($this->getStorageType()) {
            case self::STORAGE_DATA:
                return $this->file_system_service->storage();
            case self::STORAGE_WEB:
            case self::STORAGE_SECURED:
            case self::SECURED_DIRECTORY:
                return $this->file_system_service->web();
        }
        throw new LogicException('cannot determine correct filesystem');
    }

References getStorageType(), SECURED_DIRECTORY, STORAGE_DATA, STORAGE_SECURED, and STORAGE_WEB.

Referenced by ilTestProcessLockFileStorage\create(), ilAssQuestionProcessLockFileStorage\create(), create(), delete(), deleteDirectory(), deleteFile(), fileExists(), getLegacyAbsolutePath(), and getLegacyFullAbsolutePath().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLegacyAbsolutePath()

ilFileSystemAbstractionStorage::getLegacyAbsolutePath ( )

protected

Calculates the absolute filesystem storage location.

Returns: string The absolute path.

Exceptions

IOException Thrown if the directory could not be created.

Definition at line 183 of file class.ilFileSystemAbstractionStorage.php.

                                              : string
    {
        if (!$this->getFileSystemService()->has($this->path)) {
            $this->getFileSystemService()->createDir($this->path);
        }
 
        if ($this->getStorageType() === self::STORAGE_DATA) {
            return rtrim(CLIENT_DATA_DIR, '/') . '/' . ltrim($this->path, '/');
        }
        return rtrim(CLIENT_WEB_DIR, '/') . '/' . ltrim($this->path, '/');
    }

References CLIENT_DATA_DIR, CLIENT_WEB_DIR, getFileSystemService(), getStorageType(), and ILIAS\GlobalScreen\has().

Referenced by getAbsolutePath().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLegacyFullAbsolutePath()

ilFileSystemAbstractionStorage::getLegacyFullAbsolutePath ( string $relative_path )

protected

Definition at line 67 of file class.ilFileSystemAbstractionStorage.php.

                                                                       : string
    {
        $stream = $this->getFileSystemService()->readStream($relative_path);
 
        return $stream->getMetadata('uri');
    }

References getFileSystemService().

Here is the call graph for this function:

◆ getPath()

ilFileSystemAbstractionStorage::getPath ( )

Reimplemented in ilAssQuestionProcessLockFileStorage.

Definition at line 285 of file class.ilFileSystemAbstractionStorage.php.

                             : string
    {
        return $this->path;
    }

References $path.

Referenced by ilTestProcessLockFileStorage\create(), ilRestFileStorage\createFile(), ilRestFileStorage\deleteDeprecated(), ilRestFileStorage\getFile(), ilRestFileStorage\getStoredFilePath(), and ilRestFileStorage\storeFileForRest().

Here is the caller graph for this function:

◆ getPathPostfix()

ilFileSystemAbstractionStorage::getPathPostfix ( )

abstractprotected

Get directory name.

E.g for files => file Only relative path, no trailing slash '_<obj_id>' will be appended automatically

Reimplemented in ilFSStorageBlog, ilFSStorageBooking, ilFSStorageCourse, ilFSStorageExercise, ilFSWebStorageExercise, ilFSStorageFile, ilFSStorageGroup, ilIndividualAssessmentFileStorage, ilLearningSequenceFilesystem, ilFSStoragePoll, ilFSStoragePortfolio, ilFSStorageSession, ilTestProcessLockFileStorage, ilAssQuestionProcessLockFileStorage, ilFSStorageBadge, ilFSStorageBadgeImageTemplate, ilFSStorageMail, ilFSStoragePreview, ilFSStorageUserFolder, ilVerificationStorageFile, and ilRestFileStorage.

Referenced by init().

Here is the caller graph for this function:

◆ getPathPrefix()

ilFileSystemAbstractionStorage::getPathPrefix ( )

abstractprotected

Get path prefix.

Prefix that will be prepended to the path No trailing slash. E.g ilFiles for files

Reimplemented in ilFSStorageBlog, ilFSStorageBooking, ilFSStorageCourse, ilFSStorageExercise, ilFSWebStorageExercise, ilFSStorageFile, ilFSStorageGroup, ilIndividualAssessmentFileStorage, ilLearningSequenceFilesystem, ilFSStoragePoll, ilFSStoragePortfolio, ilFSStorageSession, ilTestProcessLockFileStorage, ilAssQuestionProcessLockFileStorage, ilFSStorageBadge, ilFSStorageBadgeImageTemplate, ilFSStorageMail, ilFSStoragePreview, ilFSStorageUserFolder, ilVerificationStorageFile, and ilRestFileStorage.

Referenced by init().

Here is the caller graph for this function:

◆ getStorageType()

ilFileSystemAbstractionStorage::getStorageType ( )

Definition at line 280 of file class.ilFileSystemAbstractionStorage.php.

                                    : int
    {
        return $this->storage_type;
    }

References $storage_type.

Referenced by getFileSystemService(), getLegacyAbsolutePath(), and ilFSStorageMail\getRelativePathExMailDirectory().

Here is the caller graph for this function:

◆ init()

ilFileSystemAbstractionStorage::init ( )

protected

Reimplemented in ilFSStorageExercise, ilFSWebStorageExercise, and ilRestFileStorage.

Definition at line 195 of file class.ilFileSystemAbstractionStorage.php.

                             : bool
    {
        switch ($this->storage_type) {
            case self::STORAGE_DATA:
            case self::STORAGE_WEB:
                break;
            case self::STORAGE_SECURED:
                $this->path = rtrim($this->path, '/') . '/' . self::SECURED_DIRECTORY . '/';
                break;
        }
 
        // Append path prefix
        $this->path .= ($this->getPathPrefix() . '/');
 
        if ($this->path_conversion) {
            $this->path .= self::createPathFromId($this->container_id, $this->getPathPostfix());
        } else {
            $this->path .= ($this->getPathPostfix() . '_' . $this->container_id);
        }
 
        return true;
    }

References $container_id, createPathFromId(), getPathPostfix(), getPathPrefix(), STORAGE_DATA, STORAGE_SECURED, and STORAGE_WEB.

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ writeToFile()

ilFileSystemAbstractionStorage::writeToFile	(	string	$a_data,
			$a_absolute_path
	)

Deprecated:: Please use StorageService or FilesystemService for all file opertion

Definition at line 117 of file class.ilFileSystemAbstractionStorage.php.

    {
        if (!$fp = @fopen($a_absolute_path, 'w+')) {
            return false;
        }
        if (@fwrite($fp, $a_data) === false) {
            @fclose($fp);
            return false;
        }
        @fclose($fp);
        return true;
    }