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...

	_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()

ilFileSystemStorage::_copyDirectory	(	$a_source,
		$a_target
	)

static

Copy directory and all contents.

@access public

Parameters

string	absolute source path
string	absolute target path

Definition at line 293 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 $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 $path.

◆ appendToPath()

ilFileSystemStorage::appendToPath ( $a_appendix )

Definition at line 298 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 274 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, ilTestProcessLockFileStorage, and ilAssQuestionProcessLockFileStorage.

Definition at line 135 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, ilTestProcessLockFileStorage, and ilAssQuestionProcessLockFileStorage.

Definition at line 121 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 260 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 242 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 225 of file class.ilFileSystemStorage.php.

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

Referenced by ilFSStorageCourse\deleteArchive(), 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

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

        {
                return $this->path;
        }

References $path.

Referenced by ilFSStorageSession\createDirectory(), ilFSStorageEvent\createDirectory(), delete(), ilFSStorageCourse\getArchiveDirectory(), ilFSStorageExercise\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

Definition at line 137 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 311 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, ilFSStorageFile, ilFSStorageGroup, ilFSStoragePoll, ilFSStoragePortfolio, ilFSStorageSession, ilTestProcessLockFileStorage, ilAssQuestionProcessLockFileStorage, 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, ilFSStorageFile, ilFSStorageGroup, ilFSStoragePoll, ilFSStoragePortfolio, ilFSStorageSession, ilTestProcessLockFileStorage, ilAssQuestionProcessLockFileStorage, 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, ilFSStorageFile, ilFSStorageGroup, ilFSStoragePoll, ilFSStoragePortfolio, ilFSStorageSession, ilTestProcessLockFileStorage, ilAssQuestionProcessLockFileStorage, 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, ilFSStorageFile, ilFSStorageGroup, ilFSStoragePoll, ilFSStoragePortfolio, ilFSStorageSession, ilTestProcessLockFileStorage, ilAssQuestionProcessLockFileStorage, ilFSStorageMail, ilFSStorageCourse, ilFSStorageEvent, ilFSStorageFile, ilFSStoragePreview, ilFSStorageUserFolder, ilVerificationStorageFile, and ilRestFileStorage.

◆ getShortPath()

ilFileSystemStorage::getShortPath ( )

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

        {
                return $this->short_path;
        }

References $short_path.

◆ getStorageType()

ilFileSystemStorage::getStorageType ( )

Definition at line 303 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, and ilRestFileStorage.

Definition at line 161 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(), 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, and ilRestFileStorage.

Definition at line 157 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 147 of file class.ilFileSystemStorage.php.

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

References 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 203 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;            
        }