Inheritance diagram for ilFileSystemStorage:

Collaboration diagram for ilFileSystemStorage:

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

	getContainerId ()

	create ()
	Create directory. More...

	getAbsolutePath ()
	Get absolute path of storage directory. More...

	writeToFile ($a_data, $a_absolute_path)
	Write data to file. More...

	deleteFile ($a_abs_name)
	Delete file. More...

	deleteDirectory ($a_abs_name)
	Delete directory. More...

	delete ()
	Delete complete directory. More...

	copyFile ($a_from, $a_to)
	Copy files. More...

	appendToPath ($a_appendix)

	getStorageType ()

	getPath ()
	Get path. More...

	__construct ($a_storage_type, $a_path_conversion, $a_container_id)
	Constructor. More...

	create ()
	Create directory. More...

	getAbsolutePath ()
	Get absolute path of storage directory. More...

	getShortPath ()

	rename ($from, $to)

Static Public Member Functions
static	_createPathFromId ($a_container_id, $a_name)
	Create a path from an id: e.g 12345 will be converted to 12/34/<name>_5. More...

static	_copyDirectory ($a_source, $a_target)
	Copy directory and all contents. More...

static	_createPathFromId ($a_container_id, $a_name)
	Create a path from an id: e.g 12345 will be converted to 12/34/<name>_5. More...

Data Fields
const	STORAGE_WEB = 1

const	STORAGE_DATA = 2

const	STORAGE_SECURED = 3

const	FACTOR = 100

const	MAX_EXPONENT = 3

const	SECURED_DIRECTORY = "sec"

Protected Member Functions
	getPathPrefix ()
	Get path prefix. More...

	getPathPostfix ()
	Get directory name. More...

	init ()
	Read path info. More...

	getPathPrefix ()
	Get path prefix. More...

	getPathPostfix ()
	Get directory name. More...

Protected Attributes
	$path

Private Member Functions
	init ()
	Read path info. More...

Private Attributes
	$container_id

	$storage_type

	$path_conversion = false

	$short_path

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct() [1/2]

ilFileSystemStorage::__construct	(	$a_storage_type,
		$a_path_conversion,
		$a_container_id
	)

Constructor.

@access public

Parameters

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

Definition at line 59 of file class.ilFileSystemStorage.php.

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

References init().

Here is the call graph for this function:

◆ __construct() [2/2]

ilFileSystemStorage::__construct	(	$a_storage_type,
		$a_path_conversion,
		$a_container_id
	)

Constructor.

@access public

Parameters

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

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

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

References init().

Here is the call graph for this function:

Member Function Documentation

◆ _copyDirectory()

static ilFileSystemStorage::_copyDirectory	(	$a_source,
		$a_target
	)

static

Copy directory and all contents.

Parameters

string	$a_source	absolute source path
string	$a_target	absolute target path

Definition at line 277 of file class.ilFileSystemStorage.php.

    {
        return ilUtil::rCopy($a_source, $a_target);
    }

References ilUtil\rCopy().

Referenced by ilFSStorageCourse\_clone(), and ilObjPortfolioBase\cloneBasics().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _createPathFromId() [1/2]

static ilFileSystemStorage::_createPathFromId	(	$a_container_id,
		$a_name
	)

static

Create a path from an id: e.g 12345 will be converted to 12/34/<name>_5.

@access public

Parameters

int	container id
string	name

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

    {
        $path = array();
        $found = false;
        $num = $a_container_id;
        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 ilExport\_getExportDirectory(), and init().

Here is the caller graph for this function:

◆ _createPathFromId() [2/2]

static ilFileSystemStorage::_createPathFromId	(	$a_container_id,
		$a_name
	)

static

Create a path from an id: e.g 12345 will be converted to 12/34/<name>_5.

@access public

Parameters

int	container id
string	name

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

    {
        $path = array();
        $found = false;
        $num = $a_container_id;
        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;
    }

References $i, and $path.

◆ appendToPath()

ilFileSystemStorage::appendToPath ( $a_appendix )

Definition at line 282 of file class.ilFileSystemStorage.php.

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

Referenced by ilFSStorageMail\__construct().

Here is the caller graph for this function:

◆ copyFile()

ilFileSystemStorage::copyFile	(	$a_from,
		$a_to
	)

Copy files.

@access public

Parameters

string	absolute source
string	absolute target

Definition at line 262 of file class.ilFileSystemStorage.php.

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

◆ create() [1/2]

ilFileSystemStorage::create ( )

Create directory.

@access public

Reimplemented in ilFSStorageExercise, ilFSWebStorageExercise, ilIndividualAssessmentFileStorage, ilTestProcessLockFileStorage, and ilAssQuestionProcessLockFileStorage.

Definition at line 132 of file class.ilFileSystemStorage.php.

    {
        if (!file_exists($this->path)) {
            ilUtil::makeDirParents($this->path);
        }
        return true;
    }

References ilUtil\makeDirParents().

Referenced by ilRestFileStorage\init().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ create() [2/2]

ilFileSystemStorage::create ( )

Create directory.

@access public

Reimplemented in ilFSStorageExercise, ilFSWebStorageExercise, ilIndividualAssessmentFileStorage, ilTestProcessLockFileStorage, and ilAssQuestionProcessLockFileStorage.

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

    {
        if (!file_exists($this->short_path)) {
            ilUpdateUtils::makeDirParents(ilUpdateUtils::removeTrailingPathSeparators($this->short_path));
        }
        return true;
    }

References ilUpdateUtils\makeDirParents(), and ilUpdateUtils\removeTrailingPathSeparators().

Here is the call graph for this function:

◆ delete()

ilFileSystemStorage::delete ( )

Delete complete directory.

@access public

Parameters

Definition at line 248 of file class.ilFileSystemStorage.php.

    {
        return ilUtil::delDir($this->getAbsolutePath());
    }

References ilUtil\delDir(), and getAbsolutePath().

Here is the call graph for this function:

◆ deleteDirectory()

ilFileSystemStorage::deleteDirectory ( $a_abs_name )

Delete directory.

@access public

Parameters

string absolute name

Definition at line 231 of file class.ilFileSystemStorage.php.

    {
        if (@file_exists($a_abs_name)) {
            ilUtil::delDir($a_abs_name);
            return true;
        }
        return false;
    }

References ilUtil\delDir().

Referenced by ilFSStorageCourse\deleteArchive().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteFile()

ilFileSystemStorage::deleteFile ( $a_abs_name )

Delete file.

@access public

Parameters

string absolute name

Definition at line 215 of file class.ilFileSystemStorage.php.

    {
        if (@file_exists($a_abs_name)) {
            @unlink($a_abs_name);
            return true;
        }
        return false;
    }

Referenced by ilFSStorageCourse\deleteArchive(), ilIndividualAssessmentFileStorage\deleteCurrentFile(), ilIndividualAssessmentFileStorage\deleteFileByName(), ilFSStorageCourse\deleteMemberExportFile(), and ilFSStorageGroup\deleteMemberExportFile().

Here is the caller graph for this function:

◆ getAbsolutePath() [1/2]

ilFileSystemStorage::getAbsolutePath ( )

Get absolute path of storage directory.

@access public

Reimplemented in ilIndividualAssessmentFileStorage.

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

    {
        return $this->path;
    }

References $path.

Referenced by ilFSStorageSession\createDirectory(), ilFSStorageEvent\createDirectory(), delete(), ilFSStorageCourse\getArchiveDirectory(), ilFSStorageExercise\getAssignmentFilePath(), ilFSWebStorageExercise\getAssignmentFilePath(), ilFSStorageCourse\getInfoDirectory(), ilFSStorageCourse\getMemberExportDirectory(), ilFSStorageGroup\getMemberExportDirectory(), and ilFSStorageMail\getRelativePathExMailDirectory().

Here is the caller graph for this function:

◆ getAbsolutePath() [2/2]

ilFileSystemStorage::getAbsolutePath ( )

Get absolute path of storage directory.

@access public

Reimplemented in ilIndividualAssessmentFileStorage.

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

    {
        return $this->path;
    }

References $path.

◆ getContainerId()

ilFileSystemStorage::getContainerId ( )

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

    {
        return $this->container_id;
    }

References $container_id.

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

Here is the caller graph for this function:

◆ getPath()

ilFileSystemStorage::getPath ( )

Get path.

Reimplemented in ilAssQuestionProcessLockFileStorage.

Definition at line 295 of file class.ilFileSystemStorage.php.

    {
        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() [1/2]

ilFileSystemStorage::getPathPostfix ( )

abstractprotected

Get directory name.

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

@abstract @access protected

Returns: string directory name

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

Referenced by init().

Here is the caller graph for this function:

◆ getPathPostfix() [2/2]

ilFileSystemStorage::getPathPostfix ( )

abstractprotected

Get directory name.

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

@abstract @access protected

Returns: string directory name

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

◆ getPathPrefix() [1/2]

ilFileSystemStorage::getPathPrefix ( )

abstractprotected

Get path prefix.

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

@abstract @access protected

Returns: string path prefix e.g files

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

Referenced by init().

Here is the caller graph for this function:

◆ getPathPrefix() [2/2]

ilFileSystemStorage::getPathPrefix ( )

abstractprotected

Get path prefix.

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

@abstract @access protected

Returns: string path prefix e.g files

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

◆ getShortPath()

ilFileSystemStorage::getShortPath ( )

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

    {
        return $this->short_path;
    }

References $short_path.

◆ getStorageType()

ilFileSystemStorage::getStorageType ( )

Definition at line 287 of file class.ilFileSystemStorage.php.

    {
        return $this->storage_type;
    }

References $storage_type.

Referenced by ilFSStorageMail\getRelativePathExMailDirectory().

Here is the caller graph for this function:

◆ init() [1/2]

ilFileSystemStorage::init ( )

protected

Read path info.

@access private

Reimplemented in ilFSStorageExercise, ilFSWebStorageExercise, and ilRestFileStorage.

Definition at line 157 of file class.ilFileSystemStorage.php.

    {
        switch ($this->storage_type) {
            case self::STORAGE_DATA:
                $this->path = ilUtil::getDataDir();
                break;
                
            case self::STORAGE_WEB:
                $this->path = ilUtil::getWebspaceDir();
                break;
            
            case self::STORAGE_SECURED:
                $this->path = ilUtil::getWebspaceDir();
                $this->path = ilUtil::removeTrailingPathSeparators($this->path);
                $this->path .= '/' . self::SECURED_DIRECTORY;
                break;
        }
        $this->path = ilUtil::removeTrailingPathSeparators($this->path);
        $this->path .= '/';
        
        // 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(), ilUtil\getDataDir(), getPathPostfix(), getPathPrefix(), ilUtil\getWebspaceDir(), ilUtil\removeTrailingPathSeparators(), SECURED_DIRECTORY, 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:

◆ init() [2/2]

ilFileSystemStorage::init ( )

private

Read path info.

@access private

Reimplemented in ilFSStorageExercise, ilFSWebStorageExercise, and ilRestFileStorage.

Definition at line 153 of file class.ilFileSystemStorage.php.

    {
        switch ($this->storage_type) {
            case self::STORAGE_DATA:
                $this->path = ilUpdateUtils::getDataDir();
                break;
                
            case self::STORAGE_WEB:
                $this->path = ilUpdateUtils::getWebspaceDir();
                break;
        }
        $this->path = ilUpdateUtils::removeTrailingPathSeparators($this->path);
        $this->path .= '/';
        
        // Append path prefix
        $this->path .= ($this->getPathPrefix() . '/');
        
        if ($this->path_conversion) {
            if ($path_id = self::_createPathFromId($this->container_id, $this->getPathPostfix())) {
                $this->path = $this->path . '/' . $path_id;
                $this->path .= '/';
                $this->short_path = $this->path;
            } else {
                $this->short_path = $this->path;
            }
            $this->path .= ($this->getPathPostfix() . '_' . $this->container_id);
        } else {
            $this->short_path = $this->path;
            $this->path .= ($this->getPathPostfix() . '_' . $this->container_id);
        }
        return true;
    }

References $container_id, $path, ilUpdateUtils\getDataDir(), getPathPostfix(), getPathPrefix(), ilUpdateUtils\getWebspaceDir(), ilUpdateUtils\removeTrailingPathSeparators(), STORAGE_DATA, and STORAGE_WEB.

Here is the call graph for this function:

◆ rename()

ilFileSystemStorage::rename	(	$from,
		$to
	)

Definition at line 143 of file class.ilFileSystemStorage.php.

    {
        return @rename($from, $to);
    }

References $from, and rename().

Referenced by rename(), and ilFSStorageExercise\uploadFile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ writeToFile()

ilFileSystemStorage::writeToFile	(	$a_data,
		$a_absolute_path
	)

Write data to file.

@access public

Parameters

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

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