ilObjFile Class Reference

Class ilObjFile. More...

Inheritance diagram for ilObjFile:

Collaboration diagram for ilObjFile:

Public Member Functions
	__construct ($a_id=0, $a_call_by_reference=true)
	Constructor @access public. More...
	initType ()
	createProperties ($a_upload=false, $a_prevent_meta_data_creation=false)
	The basic properties of a file object are stored in table object_data. More...
	getDirectory ($a_version=0)
	createDirectory ()
	raiseUploadError ($a_raise=true)
	getUploadFile ($a_upload_file, $a_filename, $a_prevent_preview=false)
	replaceFile ($a_upload_file, $a_filename)
	replace file with new file More...
	addFileVersion ($a_upload_file, $a_filename)
	copy ($a_source, $a_destination)
	copy file More...
	clearDataDirectory ()
	clear data directory More...
	deleteVersions ($a_hist_entry_ids=null)
	Deletes the specified history entries or all entries if no ids are specified. More...
	setFileName ($a_name)
	set filename More...
	getFileName ()
	setFileType ($a_type)
	getFileType ()
	setFileSize ($a_size)
	getFileSize ()
	getDiskUsage ()
	Gets the disk usage of the object in bytes. More...
	getFile ($a_hist_entry_id=null)
	setVersion ($a_version)
	getVersion ()
	setMode ($a_mode)
	mode is object or filelist More...
	getMode ()
	mode is object or filelist More...
	_writeFileType ($a_id, $a_format)
	_lookupFileName ($a_id)
	_lookupFileSize ($a_id)
	Lookups the file size of the file in bytes. More...
	_lookupVersion ($a_id)
	lookup version More...
	determineFileSize ($a_hist_entry_id=null)
	Determine File Size. More...
	sendFile ($a_hist_entry_id=null)
	getFileExtension ()
	Returns the extension of the file name converted to lower-case. More...
	isInline ()
	Returns true, if this file should be displayed inline in a browser window. More...
	isHidden ()
	Returns true, if this file should be hidden in the repository view. More...
	guessFileType ($a_file="")
	Guesses the file type based on the current values returned by getFileType() and getFileExtension(). More...
	export ($a_target_dir)
	export files of object to target directory note: target directory must be the export target directory, "/objects/il_<inst>_file_<file_id>/..." will be appended to this directory More...
	_deleteAllUsages ($a_type, $a_id, $a_usage_hist_nr=0, $a_usage_lang="-")
	static delete all usages of More...
	_saveUsage ($a_file_id, $a_type, $a_id, $a_usage_hist_nr=0, $a_usage_lang="-")
	save usage More...
	getUsages ()
	get all usages of file object More...
	_getFilesOfObject ($a_type, $a_id, $a_usage_hist_nr=0, $a_usage_lang="-")
	get all files of an object More...
	getXMLZip ()
	addNewsNotification ($a_lang_var)
	initFileStorage ()
	init file storage object More...
	storeUnzipedFile ($a_upload_file, $a_filename)
	storeUnzipedFile More...
	checkFileExtension ($new_filename, $new_title)
	Check if the file extension does still exist after an update of the title. More...
	getVersions ($version_ids=null)
	Gets the file versions for this object. More...
	getSpecificVersion ($version_id)
	Gets a specific file version. More...
	rollback ($version_id)
	Makes the specified version the current one and returns theSummary of rollbackVersion. More...
	compareVersions ($v1, $v2)
	Compares two file versions. More...
	parseInfoParams ($entry)
	Parses the info parameters ("info_params") of the specified history entry. More...
	setRating ($a_value)
	hasRating ()
Public Member Functions inherited from ilObject2
	__construct ($a_id=0, $a_reference=true)
	Constructor @access public. More...
	withReferences ()
	determines wehter objects are referenced or not (got ref ids or not) More...
	read ($a_force_db=false)
	Read data from db. More...
	getId ()
	get object id @access public More...
	setId ($a_id)
	set object id @access public More...
	setRefId ($a_id)
	set reference id @access public More...
	getRefId ()
	get reference id @access public More...
	getType ()
	get object type @access public More...
	setType ($a_type)
	set object type @access public More...
	getPresentationTitle ()
	get presentation title Normally same as title Overwritten for sessions More...
	getTitle ()
	get object title @access public More...
	getUntranslatedTitle ()
	get untranslated object title @access public More...
	setTitle ($a_title)
	set object title More...
	getDescription ()
	get object description More...
	setDescription ($a_desc)
	set object description More...
	getLongDescription ()
	get object long description (stored in object_description) More...
	getImportId ()
	get import id More...
	setImportId ($a_import_id)
	set import id More...
	getOwner ()
	get object owner More...
	getOwnerName ()
	_lookupOwnerName ($a_owner_id)
	lookup owner name for owner id More...
	setOwner ($a_owner)
	set object owner More...
	getCreateDate ()
	get create date @access public More...
	getLastUpdateDate ()
	get last update date @access public More...
	setObjDataRecord ($a_record)
	set object_data record (note: this method should only be called from the ilObjectFactory class) More...
	create ($a_clone_mode=false)
	update ()
	update object in db More...
	MDUpdateListener ($a_element)
	Meta data update listener. More...
	createMetaData ()
	create meta data entry More...
	updateMetaData ()
	update meta data entry More...
	deleteMetaData ()
	delete meta data entry More...
	updateOwner ()
	update owner of object in db More...
	_getIdForImportId ($a_import_id)
	get current object id for import id (static) More...
	_lookupOwner ($a_id)
	lookup object owner More...
	_lookupLastUpdate ($a_id, $a_as_string=false)
	lookup last update More...
	_getLastUpdateOfObjects ($a_objs)
	Get last update for a set of media objects. More...
	_setDeletedDate ($a_ref_id)
	only called in ilTree::saveSubTree More...
	_resetDeletedDate ($a_ref_id)
	only called in ilObjectGUI::insertSavedNodes More...
	_lookupDeletedDate ($a_ref_id)
	only called in ilObjectGUI::insertSavedNodes More...
	_writeTitle ($a_obj_id, $a_title)
	write title to db (static) More...
	_writeDescription ($a_obj_id, $a_desc)
	write description to db (static) More...
	_writeImportId ($a_obj_id, $a_import_id)
	write import id to db (static) More...
	_isInTrash ($a_ref_id)
	checks wether object is in trash More...
	_hasUntrashedReference ($a_obj_id)
	checks wether an object has at least one reference that is not in trash More...
	_getObjectsDataForType ($a_type, $a_omit_trash=false)
	get all objects of a certain type More...
	putInTree ($a_parent_ref)
	maybe this method should be in tree object!? More...
	setPermissions ($a_parent_ref)
	set permissions of object More...
	createReference ()
	creates reference for object More...
	countReferences ()
	count references of object More...
	delete ()
	delete object or referenced object (in the case of a referenced object, object data is only deleted if last reference is deleted) This function removes an object entirely from system!! More...
	initDefaultRoles ()
	init default roles settings Purpose of this function is to create a local role folder and local roles, that are needed depending on the object type If you want to setup default local roles you MUST overwrite this method in derived object classes (see ilObjForum for an example) @access public More...
	notify ($a_event, $a_ref_id, $a_parent_non_rbac_id, $a_node_id, $a_params=0)
	notifys an object about an event occured Based on the event passed, each object may decide how it reacts. More...
	setRegisterMode ($a_bool)
	isUserRegistered ($a_user_id=0)
	requireRegistration ()
	appendCopyInfo ($a_target_id, $a_copy_id)
	Prepend Copy info if object with same name exists in that container. More...
	cloneMetaData ($target_obj)
	Copy meta data. More...
	cloneObject ($a_target_id, $a_copy_id=null, $a_omit_tree=false)
	Clone object permissions, put in tree ... More...
	cloneDependencies ($a_target_id, $a_copy_id)
	Clone object dependencies. More...
Public Member Functions inherited from ilObject
	ilObject ($a_id=0, $a_reference=true)
	Constructor @access public. More...
	withReferences ()
	determines wehter objects are referenced or not (got ref ids or not) More...
	read ($a_force_db=false)
	read object data from db into object More...
	getId ()
	get object id @access public More...
	setId ($a_id)
	set object id @access public More...
	setRefId ($a_id)
	set reference id @access public More...
	getRefId ()
	get reference id @access public More...
	getType ()
	get object type @access public More...
	setType ($a_type)
	set object type @access public More...
	getPresentationTitle ()
	get presentation title Normally same as title Overwritten for sessions More...
	getTitle ()
	get object title @access public More...
	getUntranslatedTitle ()
	get untranslated object title @access public More...
	setTitle ($a_title)
	set object title More...
	getDescription ()
	get object description More...
	setDescription ($a_desc)
	set object description More...
	getLongDescription ()
	get object long description (stored in object_description) More...
	getImportId ()
	get import id More...
	setImportId ($a_import_id)
	set import id More...
	getOwner ()
	get object owner More...
	getOwnerName ()
	_lookupOwnerName ($a_owner_id)
	lookup owner name for owner id More...
	setOwner ($a_owner)
	set object owner More...
	getCreateDate ()
	get create date @access public More...
	getLastUpdateDate ()
	get last update date @access public More...
	getDiskUsage ()
	setObjDataRecord ($a_record)
	set object_data record (note: this method should only be called from the ilObjectFactory class) More...
	create ()
	create More...
	update ()
	update object in db More...
	MDUpdateListener ($a_element)
	Meta data update listener. More...
	createMetaData ()
	create meta data entry More...
	updateMetaData ()
	update meta data entry More...
	deleteMetaData ()
	delete meta data entry More...
	updateOwner ()
	update owner of object in db More...
	_getIdForImportId ($a_import_id)
	get current object id for import id (static) More...
	_lookupOwner ($a_id)
	lookup object owner More...
	_lookupLastUpdate ($a_id, $a_as_string=false)
	lookup last update More...
	_getLastUpdateOfObjects ($a_objs)
	Get last update for a set of media objects. More...
	_setDeletedDate ($a_ref_id)
	only called in ilTree::saveSubTree More...
	_resetDeletedDate ($a_ref_id)
	only called in ilObjectGUI::insertSavedNodes More...
	_lookupDeletedDate ($a_ref_id)
	only called in ilObjectGUI::insertSavedNodes More...
	_writeTitle ($a_obj_id, $a_title)
	write title to db (static) More...
	_writeDescription ($a_obj_id, $a_desc)
	write description to db (static) More...
	_writeImportId ($a_obj_id, $a_import_id)
	write import id to db (static) More...
	_isInTrash ($a_ref_id)
	checks wether object is in trash More...
	_hasUntrashedReference ($a_obj_id)
	checks wether an object has at least one reference that is not in trash More...
	_getObjectsDataForType ($a_type, $a_omit_trash=false)
	get all objects of a certain type More...
	putInTree ($a_parent_ref)
	maybe this method should be in tree object!? More...
	setPermissions ($a_parent_ref)
	set permissions of object More...
	setParentRolePermissions ($a_parent_ref)
	Initialize the permissions of parent roles (local roles of categories, global roles...) This method is overwritten in e.g courses, groups for building permission intersections with non_member templates. More...
	createReference ()
	creates reference for object More...
	countReferences ()
	count references of object More...
	delete ()
	delete object or referenced object (in the case of a referenced object, object data is only deleted if last reference is deleted) This function removes an object entirely from system!! More...
	initDefaultRoles ()
	init default roles settings Purpose of this function is to create a local role folder and local roles, that are needed depending on the object type If you want to setup default local roles you MUST overwrite this method in derived object classes (see ilObjForum for an example) @access public More...
	applyDidacticTemplate ($a_tpl_id)
	Apply template. More...
	notify ($a_event, $a_ref_id, $a_parent_non_rbac_id, $a_node_id, $a_params=0)
	notifys an object about an event occured Based on the event passed, each object may decide how it reacts. More...
	setRegisterMode ($a_bool)
	isUserRegistered ($a_user_id=0)
	requireRegistration ()
	getXMLZip ()
	getHTMLDirectory ()
	cloneObject ($a_target_id, $a_copy_id=0, $a_omit_tree=false)
	Clone object permissions, put in tree ... More...
	appendCopyInfo ($a_target_id, $a_copy_id)
	Prepend Copy info if object with same name exists in that container. More...
	cloneDependencies ($a_target_id, $a_copy_id)
	Clone object dependencies. More...
	cloneMetaData ($target_obj)
	Copy meta data. More...
	_lookupCreationDate ($a_id)
	Lookup creation date. More...

Static Public Member Functions
static	_lookupAbsolutePath ($obj_id, $a_version=null)
	return absolute path for version More...
Static Public Member Functions inherited from ilObject2
static	_lookupObjIdByImportId ($a_import_id)
static	_getAllReferences ($a_id)
	get all reference ids of object More...
static	_lookupTitle ($a_id)
	lookup object title More...
static	_getIdsForTitle ($title, $type='', $partialmatch=false)
static	_lookupDescription ($a_id)
	lookup object description More...
static	_lookupObjId ($a_id)
static	_lookupType ($a_id, $a_reference=false)
	lookup object type More...
static	_lookupObjectId ($a_ref_id)
	lookup object id More...
static	_exists ($a_id, $a_reference=false)
static	_getObjectsByType ($a_obj_type="", $a_owner="")
	Get objects by type. More...
static	_prepareCloneSelection ($a_ref_ids, $new_type)
static	_getIcon ($a_obj_id="", $a_size="big", $a_type="", $a_offline=false)
	Get icon for repository item. More...
Static Public Member Functions inherited from ilObject
static	_lookupObjIdByImportId ($a_import_id)
static	_getAllReferences ($a_id)
	get all reference ids of object More...
static	_lookupTitle ($a_id)
	lookup object title More...
static	_getIdsForTitle ($title, $type='', $partialmatch=false)
static	_lookupDescription ($a_id)
	lookup object description More...
static	_lookupObjId ($a_id)
static	setDeletedDates ($a_ref_ids)
	Set deleted date @global type $ilDB. More...
static	_lookupType ($a_id, $a_reference=false)
	lookup object type More...
static	_lookupObjectId ($a_ref_id)
	lookup object id More...
static	_exists ($a_id, $a_reference=false, $a_type=null)
	checks if an object exists in object_data@access public More...
static	_getObjectsByType ($a_obj_type="", $a_owner="")
	Get objects by type. More...
static	_prepareCloneSelection ($a_ref_ids, $new_type, $show_path=true)
	Prepare copy wizard object selection. More...
static	_getIcon ($a_obj_id="", $a_size="big", $a_type="", $a_offline=false)
	Get icon for repository item. More...
static	collectDeletionDependencies (&$deps, $a_ref_id, $a_obj_id, $a_type, $a_depth=0)
	Collect deletion dependencies. More...
static	getDeletionDependencies ($a_obj_id)
	Get deletion dependencies. More...
static	getLongDescriptions (array $a_obj_ids)
	Get long description data. More...
static	getAllOwnedRepositoryObjects ($a_user_id)
	Get all ids of objects user owns. More...
static	hasAutoRating ($a_type, $a_ref_id)
	Check if auto rating is active for parent group/course. More...

Data Fields
	$filename
	$filetype
	$filemaxsize = "20000000"
	$raise_upload_error
	$mode = "object"
Data Fields inherited from ilObject
const	TITLE_LENGTH = 255
	max length of object title More...
const	DESC_LENGTH = 128
	$ilias
	$lng
	$id
	$ref_id
	$type
	$title
	$untranslatedTitle
	$desc
	$long_desc
	$owner
	$create_date
	$last_update
	$import_id
	$register = false
	$referenced
	$objectList
	$max_title
	$max_desc
	$add_dots
	$obj_data_record
	object_data record More...

Protected Member Functions
	doCreate ($a_upload=false, $a_prevent_meta_data_creation=false)
	create object More...
	doCreateMetaData ()
	create file object meta data More...
	beforeMDUpdateListener ($a_element)
	doMDUpdateListener ($a_element)
	doRead ()
	read file properties More...
	beforeUpdate ()
	doUpdate ()
	update file More...
	doUpdateMetaData ()
	update meta data More...
	doCloneObject ($a_new_obj, $a_target_id, $a_copy_id=0)
	Clone. More...
	beforeDelete ()
	doDelete ()
	updateWithVersion ($version)
	Updates the file object with the specified file version. More...
	createPreview ($force=false)
	Creates a preview for the file object. More...
	deletePreview ()
	Deletes the preview of the file object. More...
Protected Member Functions inherited from ilObject2
	initType ()
	doRead ()
	doCreate ()
	beforeCreate ()
	doUpdate ()
	beforeUpdate ()
	doMDUpdateListener ($a_element)
	beforeMDUpdateListener ($a_element)
	doCreateMetaData ()
	beforeCreateMetaData ()
	doUpdateMetaData ()
	beforeUpdateMetaData ()
	doDelete ()
	beforeDelete ()
	doCloneObject ($new_obj, $a_target_id, $a_copy_id=null)
	beforeCloneObject ()

Static Protected Member Functions
static	handleQuotaUpdate (ilObjFile $a_file)

Protected Attributes
	$rating

Private Attributes
	$file_storage = null

Detailed Description

Class ilObjFile.

Author

Sascha Hofmann shofm.nosp@m.ann@.nosp@m.datab.nosp@m.ay.d.nosp@m.e

Version

$Id$

Definition at line 18 of file class.ilObjFile.php.

Constructor & Destructor Documentation

__construct()

ilObjFile::__construct	(		$a_id = 0,
			$a_call_by_reference = true
	)

Constructor @access public.

Parameters

integer	reference_id or object_id
boolean	treat the id as reference_id (true) or object_id (false)

Reimplemented from ilObject2.

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

        {
                $this->version = 0;
                $this->raise_upload_error = true;
                parent::__construct($a_id,$a_call_by_reference);
                
                if($this->getId())
                {
                        $this->initFileStorage();
                }
        }

References ilObject2\getId(), and initFileStorage().

Here is the call graph for this function:

Member Function Documentation

_deleteAllUsages()

ilObjFile::_deleteAllUsages	(		$a_type,
			$a_id,
			$a_usage_hist_nr = 0,
			$a_usage_lang = "-"
	)

static delete all usages of

Definition at line 862 of file class.ilObjFile.php.

        {
                global $ilDB;
                
                $and_hist = ($a_usage_hist_nr !== false)
                        ? " AND usage_hist_nr = ".$ilDB->quote($a_usage_hist_nr, "integer")
                        : "";
                
                $file_ids = array();
                $set = $ilDB->query("SELECT id FROM file_usage".
                        " WHERE usage_type = ".$ilDB->quote($a_type, "text").
                        " AND usage_id= ".$ilDB->quote($a_id, "integer").
                        " AND usage_lang= ".$ilDB->quote($a_usage_lang, "text").
                        $and_hist);
                while($row = $ilDB->fetchAssoc($set))
                {
                        $file_ids[] = $row["id"];
                }
                
                $ilDB->manipulate("DELETE FROM file_usage WHERE usage_type = ".
                        $ilDB->quote($a_type, "text").
                        " AND usage_id = ".$ilDB->quote((int) $a_id, "integer").
                        " AND usage_lang= ".$ilDB->quote($a_usage_lang, "text").
                        " AND usage_hist_nr = ".$ilDB->quote((int) $a_usage_hist_nr, "integer"));
                
                foreach($file_ids as $file_id)
                {
                        self::handleQuotaUpdate(new self($file_id, false));     
                }
        }

References $ilDB, $row, and handleQuotaUpdate().

Referenced by ilPCFileList\beforePageDelete(), and ilPCFileList\saveFileUsage().

Here is the call graph for this function:

Here is the caller graph for this function:

_getFilesOfObject()

ilObjFile::_getFilesOfObject	(		$a_type,
			$a_id,
			$a_usage_hist_nr = 0,
			$a_usage_lang = "-"
	)

get all files of an object

Parameters

string	$a_type	object type (e.g. "lm:pg")
int	$a_id	object id

Returns

array array of file ids

Definition at line 962 of file class.ilObjFile.php.

        {
                global $ilDB;
 
                // get usages in learning modules
                $q = "SELECT * FROM file_usage WHERE ".
                        "usage_id = ".$ilDB->quote((int) $a_id, "integer")." AND ".
                        "usage_type = ".$ilDB->quote((string) $a_type, "text")." AND ".
                        "usage_lang = ".$ilDB->quote((string) $a_usage_lang, "text")." AND ".
                        "usage_hist_nr = ".$ilDB->quote((int) $a_usage_hist_nr, "integer");
                $file_set = $ilDB->query($q);
                $ret = array();
                while($file_rec = $ilDB->fetchAssoc($file_set))
                {
                        $ret[$file_rec["id"]] = $file_rec["id"];
                }
 
                return $ret;
        }

References $ilDB, and $ret.

Referenced by ilPCFileList\afterPageUpdate(), ilCOPageHTMLExport\collectPageElements(), ilObjGlossary\exportHTMLGlossaryTerms(), ilObjContentObject\exportHTMLGlossaryTerms(), ilObjContentObject\exportHTMLPages(), ilPageObject\getLastUpdateOfIncludedElements(), and ilCOPageExporter\getXmlExportHeadDependencies().

Here is the caller graph for this function:

_lookupAbsolutePath()

static ilObjFile::_lookupAbsolutePath (   $obj_id,   $a_version = null  )

static

return absolute path for version

Definition at line 1065 of file class.ilObjFile.php.

        {
                $file_storage = new ilFSStorageFile($obj_id);
                $filename = ilObjFile::_lookupFileName($obj_id);
                $version_subdir = "";
                
                if (!is_numeric($a_version))
                {
                        $a_version = ilObjFile::_lookupVersion ($obj_id);
                }
                $version_subdir = DIRECTORY_SEPARATOR.sprintf("%03d", $a_version);              
                return $file_storage->getAbsolutePath().$version_subdir.DIRECTORY_SEPARATOR.$filename;
        }

References $file_storage, $filename, _lookupFileName(), and _lookupVersion().

Referenced by ilContainerGUI\copyFile(), ilObjFolder\recurseFolder(), and ilObjWorkspaceFolder\recurseFolder().

Here is the call graph for this function:

Here is the caller graph for this function:

_lookupFileName()

ilObjFile::_lookupFileName

(

$a_id

)

Definition at line 554 of file class.ilObjFile.php.

        {
                global $ilDB;
 
                $q = "SELECT * FROM file_data WHERE file_id = ".$ilDB->quote($a_id ,'integer');
                $r = $ilDB->query($q);
                $row = $r->fetchRow(DB_FETCHMODE_OBJECT);
 
                return ilUtil::stripSlashes($row->file_name);
        }

References $ilDB, $row, DB_FETCHMODE_OBJECT, and ilUtil\stripSlashes().

Referenced by _lookupAbsolutePath(), ilSCORM2004PageGUI\setDefaultLinkXml(), and ilFilePreviewRenderer\supports().

Here is the call graph for this function:

Here is the caller graph for this function:

_lookupFileSize()

ilObjFile::_lookupFileSize

(

$a_id

)

Lookups the file size of the file in bytes.

Definition at line 567 of file class.ilObjFile.php.

        {
            require_once("./Modules/File/classes/class.ilObjFileAccess.php");
                return ilObjFileAccess::_lookupFileSize($a_id);
        }

References ilObjFileAccess\_lookupFileSize().

Referenced by ilPageObject\addFileSizes(), ilObjFileDAV\getContentLength(), and ilObjFileGUI\infoScreenForward().

Here is the call graph for this function:

Here is the caller graph for this function:

_lookupVersion()

ilObjFile::_lookupVersion

(

$a_id

)

lookup version

Definition at line 576 of file class.ilObjFile.php.

        {
                require_once("./Modules/File/classes/class.ilObjFileAccess.php");
                return ilObjFileAccess::_lookupVersion($a_id);
        }

References ilObjFileAccess\_lookupVersion().

Referenced by _lookupAbsolutePath().

Here is the call graph for this function:

Here is the caller graph for this function:

_saveUsage()

ilObjFile::_saveUsage	(		$a_file_id,
			$a_type,
			$a_id,
			$a_usage_hist_nr = 0,
			$a_usage_lang = "-"
	)

save usage

Definition at line 896 of file class.ilObjFile.php.

        {
                global $ilDB;
                
                /*
                $ilDB->manipulate("DELETE FROM file_usage WHERE usage_type = ".
                        $ilDB->quote((string) $a_type, "text").
                        " AND usage_id = ".$ilDB->quote((int) $a_id, "integer").
                        " AND usage_lang = ".$ilDB->quote($a_usage_lang, "text").
                        " AND usage_hist_nr = ".$ilDB->quote((int) $a_usage_hist_nr, "integer").
                        " AND id = ".$ilDB->quote((int) $a_file_id, "integer"));
 
                $ilDB->manipulate("INSERT INTO file_usage (id, usage_type, usage_id, usage_hist_nr, usage_lang) VALUES".
                        " (".$ilDB->quote((int) $a_file_id, "integer").",".
                        $ilDB->quote((string) $a_type, "text").",".
                        $ilDB->quote((int) $a_id, "integer").",".
                        $ilDB->quote((int) $a_usage_hist_nr, "integer").",".
                        $ilDB->quote($a_usage_lang, "text").
                        ")");
                */
                
                // #15143
                $ilDB->replace("file_usage",
                        array(
                                "id" => array("integer", (int) $a_file_id),
                                "usage_type" => array("text", (string) $a_type),
                                "usage_id" => array("integer", (int) $a_id),
                                "usage_hist_nr" => array("integer", (int) $a_usage_hist_nr),
                                "usage_lang" => array("text", $a_usage_lang)
                        ),
                        array()
                );
                
                self::handleQuotaUpdate(new self($a_file_id, false));           
        }

References $ilDB, and handleQuotaUpdate().

Referenced by ilPCFileList\saveFileUsage().

Here is the call graph for this function:

Here is the caller graph for this function:

_writeFileType()

ilObjFile::_writeFileType	(		$a_id,
			$a_format
	)

Definition at line 543 of file class.ilObjFile.php.

        {
                global $ilDB;
                
                $q = "UPDATE file_data SET ".
                        " file_type = ".$ilDB->quote($a_format ,'text').
                        " WHERE file_id = ".$ilDB->quote($a_id ,'integer');
                $res = $ilDB->manipulate($q);
                
        }

References $ilDB, and $res.

Referenced by doMDUpdateListener().

Here is the caller graph for this function:

addFileVersion()

ilObjFile::addFileVersion	(		$a_upload_file,
			$a_filename
	)

Definition at line 250 of file class.ilObjFile.php.

        {
                $this->getUploadFile($a_upload_file, $a_filename, true);
                
                require_once("./Services/History/classes/class.ilHistory.php");
                ilHistory::_createEntry(
                        $this->getId(),
                        "new_version",
                        $a_filename.",".$this->getVersion()
                );
                $this->setFilename($a_filename);
                $this->addNewsNotification("file_updated");
                                
                // create preview
                $this->createPreview($this->getVersion() > 1);
        }

References ilHistory\_createEntry(), addNewsNotification(), createPreview(), ilObject2\getId(), getUploadFile(), and getVersion().

Here is the call graph for this function:

addNewsNotification()

ilObjFile::addNewsNotification

(

$a_lang_var

)

Definition at line 995 of file class.ilObjFile.php.

        {
                // BEGIN WebDAV Suppress news notification for hidden files
                if ($this->isHidden()) {
                        return;
                }
                // END WebDAV Suppress news notification for hidden files
                
                global $ilUser;
                
                // Add Notification to news
                include_once("./Services/News/classes/class.ilNewsItem.php");
                include_once("./Modules/File/classes/class.ilObjFileAccess.php");
                $news_item = new ilNewsItem();
                $news_item->setContext($this->getId(), $this->getType());
                $news_item->setPriority(NEWS_NOTICE);
                $news_item->setTitle($a_lang_var);
                $news_item->setContentIsLangVar(true);
                if ($this->getDescription() != "")
                {
                        $news_item->setContent(
                                "<p>".
                                $this->getDescription()."</p>");
                }
                $news_item->setUserId($ilUser->getId());
                $news_item->setVisibility(NEWS_USERS);
                $news_item->create();
        }

References $ilUser, ilObject2\getDescription(), ilObject2\getId(), ilObject2\getType(), isHidden(), NEWS_NOTICE, and NEWS_USERS.

Referenced by addFileVersion(), createProperties(), replaceFile(), and rollback().

Here is the call graph for this function:

Here is the caller graph for this function:

beforeDelete()

ilObjFile::beforeDelete ( )

protected

Reimplemented from ilObject2.

Definition at line 794 of file class.ilObjFile.php.

        {
                global $ilDB;
                
                // check, if file is used somewhere
                $usages = $this->getUsages();
                if (count($usages) == 0)
                {
                        return true;
                }
                return false;
        }

References $ilDB, and getUsages().

Here is the call graph for this function:

beforeMDUpdateListener()

ilObjFile::beforeMDUpdateListener (   $a_element )

protected

Reimplemented from ilObject2.

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

        {
                // Check file extension
                // Removing the file extension is not allowed
                include_once 'Services/MetaData/classes/class.ilMD.php';
                $md = new ilMD($this->getId(),0, $this->getType());
                if(!is_object($md_gen = $md->getGeneral()))
                {
                        return false;
                }
                $title = $this->checkFileExtension($this->getFileName(), $md_gen->getTitle());
                $md_gen->setTitle($title);
                $md_gen->update();
                return true;
        }

References ilObject\$title, checkFileExtension(), getFileName(), ilObject2\getId(), and ilObject2\getType().

Here is the call graph for this function:

beforeUpdate()

ilObjFile::beforeUpdate ( )

protected

Reimplemented from ilObject2.

Definition at line 377 of file class.ilObjFile.php.

        {
                // no meta data handling for file list files
                if ($this->getMode() != "filelist")
                {
                        $this->updateMetaData();
                }
                
                return true;
        }

References getMode(), and ilObject2\updateMetaData().

Here is the call graph for this function:

checkFileExtension()

ilObjFile::checkFileExtension	(		$new_filename,
			$new_title
	)

Check if the file extension does still exist after an update of the title.

Returns

Definition at line 1083 of file class.ilObjFile.php.

        {
                include_once './Modules/File/classes/class.ilObjFileAccess.php';
                $fileExtension = ilObjFileAccess::_getFileExtension($new_filename);
                $titleExtension = ilObjFileAccess::_getFileExtension($new_title);
                if ($titleExtension != $fileExtension && strlen($fileExtension) > 0)
                {
                        // remove old extension
                        $pi = pathinfo($this->getFileName());
                        $suffix = $pi["extension"];
                        if ($suffix != "")
                        { 
                                if (substr($new_title,
                                        strlen($new_title) - strlen($suffix) - 1)
                                        == ".".$suffix)
                                {
                                        $new_title = substr($new_title, 0, strlen($new_title) - strlen($suffix) - 1);
                                }
                        }
                        $new_title .= '.'.$fileExtension;
                }
                return $new_title;
        }

References ilObjFileAccess\_getFileExtension(), and getFileName().

Referenced by beforeMDUpdateListener(), and updateWithVersion().

Here is the call graph for this function:

Here is the caller graph for this function:

clearDataDirectory()

ilObjFile::clearDataDirectory

(

)

clear data directory

Definition at line 279 of file class.ilObjFile.php.

        {
                ilUtil::delDir($this->getDirectory());
                $this->createDirectory();
        }

References createDirectory(), ilUtil\delDir(), and getDirectory().

Referenced by deleteVersions().

Here is the call graph for this function:

Here is the caller graph for this function:

compareVersions()

ilObjFile::compareVersions	(		$v1,
			$v2
	)

Compares two file versions.

Parameters

array	$v1	First file version to compare.
array	$v2	Second file version to compare.

Returns

int Returns an integer less than, equal to, or greater than zero if the first argument is considered to be respectively less than, equal to, or greater than the second.

Definition at line 1248 of file class.ilObjFile.php.

        {
                // v2 - v1 because version should be descending
                return (int)$v2["version"] - (int)$v1["version"];
        }

copy()

ilObjFile::copy	(		$a_source,
			$a_destination
	)

copy file

Definition at line 271 of file class.ilObjFile.php.

        {
                return copy($a_source,$this->getDirectory()."/".$a_destination);
        }

References copy(), and getDirectory().

Referenced by copy(), and rollback().

Here is the call graph for this function:

Here is the caller graph for this function:

createDirectory()

ilObjFile::createDirectory

(

)

Definition at line 197 of file class.ilObjFile.php.

        {
                ilUtil::makeDirParents($this->getDirectory());
        }

References getDirectory(), and ilUtil\makeDirParents().

Referenced by clearDataDirectory().

Here is the call graph for this function:

Here is the caller graph for this function:

createPreview()

ilObjFile::createPreview (   $force = false )

protected

Creates a preview for the file object.

Parameters

bool

$force

true, to force the creation of the preview; false, to create the preview only if the file is newer.

Definition at line 1318 of file class.ilObjFile.php.

        {
                // only normal files are supported
                if ($this->getMode() != "object")
                        return;
                
                require_once("./Services/Preview/classes/class.ilPreview.php");
                ilPreview::createPreview($this, $force);
        }

References ilPreview\createPreview(), and getMode().

Referenced by addFileVersion(), getUploadFile(), replaceFile(), storeUnzipedFile(), and updateWithVersion().

Here is the call graph for this function:

Here is the caller graph for this function:

createProperties()

ilObjFile::createProperties	(		$a_upload = false,
			$a_prevent_meta_data_creation = false
	)

The basic properties of a file object are stored in table object_data.

This is not sufficient for a file object. Therefore we create additional properties in table file_data. This method has been put into a separate operation, to allow a WebDAV Null resource (class.ilObjNull.php) to become a file object.

Definition at line 73 of file class.ilObjFile.php.

        {
                global $ilDB,$tree;
                
                // Create file directory
                $this->initFileStorage();
                $this->file_storage->create();
                
                if($a_upload)
                {
                        return true;
                }
                
                // not upload mode
                require_once("./Services/History/classes/class.ilHistory.php");
                ilHistory::_createEntry($this->getId(), "create", $this->getFileName().",1");
                $this->addNewsNotification("file_created");
 
 
                require_once("./Services/News/classes/class.ilNewsItem.php");
                $default_visibility = ilNewsItem::_getDefaultVisibilityForRefId($_GET['ref_id']);
                if ($default_visibility == "public")
                {
                        ilBlockSetting::_write("news", "public_notifications",
                                1, 0, $this->getId());
                }
 
                $q = "INSERT INTO file_data (file_id,file_name,file_type,file_size,version,f_mode) "
                        ."VALUES (".$ilDB->quote($this->getId() ,'integer').","
                        .$ilDB->quote($this->getFileName() ,'text').","
                        .$ilDB->quote($this->getFileType() ,'text').","
                        .$ilDB->quote((int) $this->getFileSize() ,'integer').","
                        .$ilDB->quote(1 ,'integer').",".$ilDB->quote($this->getMode() ,'text').")";
                $res = $ilDB->manipulate($q);
                
                // no meta data handling for file list files
                if ($this->getMode() != "filelist" && !$a_prevent_meta_data_creation)
                {
                        $this->createMetaData();
                }
        }

References $_GET, $ilDB, $res, ilHistory\_createEntry(), ilNewsItem\_getDefaultVisibilityForRefId(), ilBlockSetting\_write(), addNewsNotification(), ilObject2\createMetaData(), getFileName(), getFileSize(), getFileType(), ilObject2\getId(), getMode(), and initFileStorage().

Referenced by doCreate().

Here is the call graph for this function:

Here is the caller graph for this function:

deletePreview()

ilObjFile::deletePreview ( )

protected

Deletes the preview of the file object.

Definition at line 1331 of file class.ilObjFile.php.

        {
                // only normal files are supported
                if ($this->getMode() != "object")
                        return;
                
                require_once("./Services/Preview/classes/class.ilPreview.php");
                ilPreview::deletePreview($this->getId());
        }       

References ilPreview\deletePreview(), ilObject2\getId(), and getMode().

Referenced by doDelete().

Here is the call graph for this function:

Here is the caller graph for this function:

deleteVersions()

ilObjFile::deleteVersions

(

$a_hist_entry_ids = null

)

Deletes the specified history entries or all entries if no ids are specified.

Parameters

array

$a_hist_entry_ids

The ids of the entries to delete or null to delete all entries

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

        {
                global $ilDB;
                
                require_once("./Services/History/classes/class.ilHistory.php");
                
                if ($a_hist_entry_ids == null || count($a_hist_entry_ids) < 1)
                {
                        $ilDB->manipulate("UPDATE file_data SET version = 1 WHERE file_id = ".$ilDB->quote($this->getId() ,'integer'));
                        $this->setVersion(0);
                        $this->clearDataDirectory();
                
                        ilHistory::_removeEntriesForObject($this->getId());
                        
                        self::handleQuotaUpdate($this);
                }
                else
                {
                        $actualVersionDeleted = false;
                        
                        // get all versions
                        $versions = $this->getVersions();
                        
                        // delete each version
                        foreach ($a_hist_entry_ids as $hist_id)
                        {
                                $entry = null;
                                
                                // get version
                                foreach ($versions as $index => $version)
                                {
                                        if ($version["hist_entry_id"] == $hist_id)      
                                        {
                                                // remove each history entry
                                                ilHistory::_removeEntryByHistoryID($hist_id);
                                
                                                // delete directory                             
                                                $version_dir = $this->getDirectory($version["version"]);
                                                ilUtil::delDir($version_dir);
                                                
                                                // is actual version?
                                                if ($version["version"] == $this->getVersion())
                                                        $actualVersionDeleted = true;
                                                
                                                // remove from array
                                                unset($versions[$index]);                                               
                                                break;
                                        }
                                }
                        }
                        
                        // update actual version if it was deleted before
                        if ($actualVersionDeleted)
                        {                       
                                // get newest version (already sorted by getVersions) 
                                $version = reset($versions);
                                $this->updateWithVersion($version);
                        }
                        else
                        {
                                // updateWithVersion() will trigger quota, too
                                self::handleQuotaUpdate($this);
                        }
                }                               
        }

References $ilDB, ilHistory\_removeEntriesForObject(), ilHistory\_removeEntryByHistoryID(), clearDataDirectory(), ilUtil\delDir(), getDirectory(), ilObject2\getId(), getVersion(), getVersions(), handleQuotaUpdate(), setVersion(), and updateWithVersion().

Here is the call graph for this function:

determineFileSize()

ilObjFile::determineFileSize

(

$a_hist_entry_id = null

)

Determine File Size.

Definition at line 585 of file class.ilObjFile.php.

        {
                if (is_null($a_hist_entry_id))
                {
                        $file = $this->getDirectory($this->getVersion())."/".$this->getFileName();
                }
                else
                {
                        require_once("./Services/History/classes/class.ilHistory.php");
                        $entry = ilHistory::_getEntryByHistoryID($a_hist_entry_id);
                        
                        if ($entry === false)
                        {
                                return false;
                        }
 
                        $data = $this->parseInfoParams($entry);
                        $file = $this->getDirectory($data["version"])."/".$data["filename"];
                }
                if (is_file($file))
                {
                        $this->setFileSize(filesize($file));
                }
        }

References $data, $file, ilHistory\_getEntryByHistoryID(), getDirectory(), getFileName(), getVersion(), parseInfoParams(), and setFileSize().

Referenced by updateWithVersion().

Here is the call graph for this function:

Here is the caller graph for this function:

doCloneObject()

ilObjFile::doCloneObject (   $a_new_obj,   $a_target_id,   $a_copy_id = 0  )

protected

Clone.

@access public

Parameters

object	clone
int	target id
int	copy id

Reimplemented from ilObject2.

Definition at line 759 of file class.ilObjFile.php.

        {
                global $ilDB;
 
                $a_new_obj->createDirectory();
                $this->cloneMetaData($a_new_obj);
                
                // Copy all file versions
                ilUtil::rCopy($this->getDirectory(),$a_new_obj->getDirectory());
                
                // object created now copy other settings
                $query = "INSERT INTO file_data (file_id,file_name,file_type,file_size,version,rating,f_mode) VALUES (".
                                $ilDB->quote($a_new_obj->getId() ,'integer').",".
                                $ilDB->quote($this->getFileName() ,'text').",".
                                $ilDB->quote($this->getFileType() ,'text').",".
                                $ilDB->quote((int) $this->getFileSize() ,'integer').", ".
                                $ilDB->quote($this->getVersion() ,'integer').", ".
                                $ilDB->quote($this->hasRating() ,'integer').", ".
                                $ilDB->quote($this->getMode() ,'text').")";
                $res = $ilDB->manipulate($query);
                 
                // copy all previews
                require_once("./Services/Preview/classes/class.ilPreview.php");
                ilPreview::copyPreviews($this->getId(), $a_new_obj->getId());
 
                // copy history entries
                require_once("./Services/History/classes/class.ilHistory.php");
                ilHistory::_copyEntriesForObject($this->getId(),$a_new_obj->getId());
                
                // add news notification
                $a_new_obj->addNewsNotification("file_created");
 
                return $a_new_obj;
        }

References $ilDB, $query, $res, ilHistory\_copyEntriesForObject(), ilObject2\cloneMetaData(), ilPreview\copyPreviews(), getDirectory(), getFileName(), getFileSize(), getFileType(), ilObject2\getId(), getMode(), getVersion(), hasRating(), and ilUtil\rCopy().

Here is the call graph for this function:

doCreate()

ilObjFile::doCreate (   $a_upload = false,   $a_prevent_meta_data_creation = false  )

protected

create object

Parameters

bool	upload mode (if enabled no entries in file_data will be done)

Definition at line 58 of file class.ilObjFile.php.

        {
                //BEGIN WebDAV Move Property creation into a method of its own.
                $this->createProperties($a_upload);
                //END WebDAV Move Property creation into a method of its own.   
        }

References createProperties().

Here is the call graph for this function:

doCreateMetaData()

ilObjFile::doCreateMetaData ( )

protected

create file object meta data

Reimplemented from ilObject2.

Definition at line 119 of file class.ilObjFile.php.

        {
                // add technical section with file size and format
                $md_obj =& new ilMD($this->getId(),0,$this->getType());
                $technical = $md_obj->addTechnical();
                $technical->setSize($this->getFileSize());
                $technical->save();
                $format = $technical->addFormat();
                $format->setFormat($this->getFileType());
                $format->save();
                $technical->update();
        }

References getFileSize(), getFileType(), ilObject2\getId(), and ilObject2\getType().

Here is the call graph for this function:

doDelete()

ilObjFile::doDelete ( )

protected

Reimplemented from ilObject2.

Definition at line 807 of file class.ilObjFile.php.

        {
                global $ilDB;
                
                // delete file data entry
                $q = "DELETE FROM file_data WHERE file_id = ".$ilDB->quote($this->getId() ,'integer');
                $this->ilias->db->query($q);
 
                // delete history entries
                require_once("./Services/History/classes/class.ilHistory.php");
                ilHistory::_removeEntriesForObject($this->getId());
 
                // delete entire directory and its content
                if (@is_dir($this->getDirectory()))
                {
                        ilUtil::delDir($this->getDirectory());
                }
 
                // delete meta data
                if ($this->getMode() != "filelist")
                {
                        $this->deleteMetaData();
                }
                
                self::handleQuotaUpdate($this);
 
                // delete preview
                $this->deletePreview();
        }

References $ilDB, ilHistory\_removeEntriesForObject(), ilUtil\delDir(), ilObject2\deleteMetaData(), deletePreview(), getDirectory(), ilObject2\getId(), getMode(), and handleQuotaUpdate().

Here is the call graph for this function:

doMDUpdateListener()

ilObjFile::doMDUpdateListener (   $a_element )

protected

Reimplemented from ilObject2.

Definition at line 148 of file class.ilObjFile.php.

        {
                // handling for technical section 
                include_once 'Services/MetaData/classes/class.ilMD.php';
//echo "-".$a_element."-";
                switch($a_element)
                {
                        case 'Technical':
 
                                // Update Format (size is not stored in db)
                                $md = new ilMD($this->getId(),0, $this->getType());
                                if(!is_object($md_technical = $md->getTechnical()))
                                {
                                        return false;
                                }
 
                                foreach($md_technical->getFormatIds() as $id)
                                {
                                        $md_format = $md_technical->getFormat($id);
                                        ilObjFile::_writeFileType($this->getId(),$md_format->getFormat());
                                        $this->setFileType($md_format->getFormat());
                                        break;
                                }
 
                                break;
                }
                return true;
        }

References ilObject\$id, _writeFileType(), ilObject2\getId(), ilObject2\getType(), and setFileType().

Here is the call graph for this function:

doRead()

ilObjFile::doRead ( )

protected

read file properties

Reimplemented from ilObject2.

Definition at line 359 of file class.ilObjFile.php.

        {
                global $ilDB;
                
                $q = "SELECT * FROM file_data WHERE file_id = ".$ilDB->quote($this->getId() ,'integer');
                $r = $this->ilias->db->query($q);
                $row = $r->fetchRow(DB_FETCHMODE_OBJECT);
 
                $this->setFileName($row->file_name);
                $this->setFileType($row->file_type);
                $this->setFileSize($row->file_size);
                $this->setVersion($row->version);
                $this->setMode($row->f_mode);
                $this->setRating($row->rating);
                
                $this->initFileStorage();
        }

References $ilDB, $row, DB_FETCHMODE_OBJECT, ilObject2\getId(), initFileStorage(), setFileName(), setFileSize(), setFileType(), setMode(), setRating(), and setVersion().

Here is the call graph for this function:

doUpdate()

ilObjFile::doUpdate ( )

protected

update file

Reimplemented from ilObject2.

Definition at line 391 of file class.ilObjFile.php.

        {
                global $ilDB, $ilLog;
                
                //$ilLog->write(__METHOD__.' File type: '.$this->getFileType());
                
                $q = "UPDATE file_data SET file_name = ".$ilDB->quote($this->getFileName() ,'text').
                        ", file_type = ".$ilDB->quote($this->getFiletype() ,'text')." ".
                        ", file_size = ".$ilDB->quote((int) $this->getFileSize() ,'integer')." ".
                        ", version = ".$ilDB->quote($this->getVersion() ,'integer')." ".
                        ", f_mode = ".$ilDB->quote($this->getMode() ,'text')." ".
                        ", rating = ".$ilDB->quote($this->hasRating() ,'integer')." ".
                        "WHERE file_id = ".$ilDB->quote($this->getId() ,'integer');
                $res = $ilDB->manipulate($q);
                
                self::handleQuotaUpdate($this);
                
                return true;
        }

References $ilDB, $ilLog, $res, getFileName(), getFileSize(), ilObject2\getId(), getMode(), getVersion(), handleQuotaUpdate(), and hasRating().

Here is the call graph for this function:

doUpdateMetaData()

ilObjFile::doUpdateMetaData ( )

protected

update meta data

Reimplemented from ilObject2.

Definition at line 414 of file class.ilObjFile.php.

        {
                // add technical section with file size and format
                $md_obj =& new ilMD($this->getId(),0,$this->getType());
                if(!is_object($technical = $md_obj->getTechnical()))
                {
                        $technical = $md_obj->addTechnical();
                        $technical->save();
                }
                $technical->setSize($this->getFileSize());
                
                $format_ids = $technical->getFormatIds();
                if (count($format_ids) > 0)
                {
                        $format = $technical->getFormat($format_ids[0]);
                        $format->setFormat($this->getFileType());
                        $format->update();
                }
                else
                {
                        $format = $technical->addFormat();
                        $format->setFormat($this->getFileType());
                        $format->save();
                }
                $technical->update();
        }

References getFileSize(), getFileType(), ilObject2\getId(), and ilObject2\getType().

Here is the call graph for this function:

export()

ilObjFile::export

(

$a_target_dir

)

export files of object to target directory note: target directory must be the export target directory, "/objects/il_<inst>_file_<file_id>/..." will be appended to this directory

Parameters

string

$a_target_dir

target directory

Definition at line 844 of file class.ilObjFile.php.

        {
                $subdir = "il_".IL_INST_ID."_file_".$this->getId();
                ilUtil::makeDir($a_target_dir."/objects/".$subdir);
 
                $filedir = $this->getDirectory($this->getVersion());
                
                if (@!is_dir($filedir))
                {
                        $filedir = $this->getDirectory();
                }
                
                ilUtil::rCopy($filedir, $a_target_dir."/objects/".$subdir);
        }

References getDirectory(), ilObject2\getId(), getVersion(), ilUtil\makeDir(), and ilUtil\rCopy().

Here is the call graph for this function:

getDirectory()

ilObjFile::getDirectory

(

$a_version = 0

)

Definition at line 178 of file class.ilObjFile.php.

        {
                $version_subdir = "";
 
                if ($a_version)
                {
                        // BEGIN WebDAV Avoid double slash before version subdirectory
                        $version_subdir = sprintf("%03d", $a_version);
                        // END WebDAV Avoid  double slash before version subdirectory
                }
                
                if(!is_object($this->file_storage))
                {
                        $this->initFileStorage();
                }
                
                return $this->file_storage->getAbsolutePath().'/'.$version_subdir;
        }

References initFileStorage().

Referenced by clearDataDirectory(), copy(), createDirectory(), deleteVersions(), determineFileSize(), doCloneObject(), doDelete(), export(), getFile(), getUploadFile(), getXMLZip(), rollback(), sendFile(), and storeUnzipedFile().

Here is the call graph for this function:

Here is the caller graph for this function:

getDiskUsage()

ilObjFile::getDiskUsage

(

)

Gets the disk usage of the object in bytes.

@access public

Returns

integer the disk usage in bytes

Reimplemented from ilObject.

Definition at line 482 of file class.ilObjFile.php.

        {
            require_once("./Modules/File/classes/class.ilObjFileAccess.php");
                return ilObjFileAccess::_lookupDiskUsage($this->id);
        }

References ilObjFileAccess\_lookupDiskUsage().

Referenced by handleQuotaUpdate().

Here is the call graph for this function:

Here is the caller graph for this function:

getFile()

ilObjFile::getFile

(

$a_hist_entry_id = null

)

Definition at line 490 of file class.ilObjFile.php.

        {
                if (is_null($a_hist_entry_id))
                {
                        $file = $this->getDirectory($this->getVersion())."/".$this->getFileName();
                }
                else
                {
                        require_once("./Services/History/classes/class.ilHistory.php");
                        $entry = ilHistory::_getEntryByHistoryID($a_hist_entry_id);
                        
                        if ($entry === false)
                        {
                                return false;
                        }
 
                        $data = $this->parseInfoParams($entry);
                        $file = $this->getDirectory($data["version"])."/".$data["filename"];
                }
                return $file;
        }

References $data, $file, ilHistory\_getEntryByHistoryID(), getDirectory(), getFileName(), getVersion(), and parseInfoParams().

Here is the call graph for this function:

getFileExtension()

ilObjFile::getFileExtension

(

)

Returns the extension of the file name converted to lower-case.

e.g. returns 'pdf' for 'document.pdf'.

Definition at line 669 of file class.ilObjFile.php.

                                    {
                require_once 'Modules/File/classes/class.ilObjFileAccess.php';
                return ilObjFileAccess::_getFileExtension($this->getTitle());
        }

References ilObjFileAccess\_getFileExtension(), and ilObject2\getTitle().

Here is the call graph for this function:

getFileName()

ilObjFile::getFileName

(

)

Definition at line 449 of file class.ilObjFile.php.

        {
                return $this->filename;
        }

References $filename.

Referenced by beforeMDUpdateListener(), checkFileExtension(), createProperties(), determineFileSize(), doCloneObject(), doUpdate(), getFile(), and sendFile().

Here is the caller graph for this function:

getFileSize()

ilObjFile::getFileSize

(

)

Definition at line 472 of file class.ilObjFile.php.

        {
                return $this->filesize;
        }

Referenced by createProperties(), doCloneObject(), doCreateMetaData(), doUpdate(), and doUpdateMetaData().

Here is the caller graph for this function:

getFileType()

ilObjFile::getFileType

(

)

Definition at line 462 of file class.ilObjFile.php.

        {
                return $this->filetype;
        }

References $filetype.

Referenced by createProperties(), doCloneObject(), doCreateMetaData(), doUpdateMetaData(), and guessFileType().

Here is the caller graph for this function:

getMode()

ilObjFile::getMode

(

)

mode is object or filelist

Returns

string mode

Definition at line 538 of file class.ilObjFile.php.

        {
                return $this->mode;
        }

References $mode.

Referenced by beforeUpdate(), createPreview(), createProperties(), deletePreview(), doCloneObject(), doDelete(), and doUpdate().

Here is the caller graph for this function:

getSpecificVersion()

ilObjFile::getSpecificVersion

(

$version_id

)

Gets a specific file version.

Parameters

int

$version_id

The version id to get.

Returns

array The specific version or false if the version was not found.

Definition at line 1148 of file class.ilObjFile.php.

        {
                include_once("./Services/History/classes/class.ilHistory.php");
                $version = ilHistory::_getEntryByHistoryID($version_id);
                if ($version === false)
                        return false;
                
                // ilHistory returns different keys in _getEntryByHistoryID and _getEntriesForObject
                // so this makes it the same
                $version["hist_entry_id"] = $version["id"];
                $version["user_id"] = $version["usr_id"];
                $version["date"] = $version["hdate"];
                unset($version["id"], $version["usr_id"], $version["hdate"]);
                
                // parse params
                $params = $this->parseInfoParams($version);
                return array_merge($version, $params);
        }

References ilHistory\_getEntryByHistoryID(), and parseInfoParams().

Referenced by rollback().

Here is the call graph for this function:

Here is the caller graph for this function:

getUploadFile()

ilObjFile::getUploadFile	(		$a_upload_file,
			$a_filename,
			$a_prevent_preview = false
	)

Definition at line 207 of file class.ilObjFile.php.

        {
                $this->setVersion($this->getVersion() + 1);
 
                if (@!is_dir($this->getDirectory($this->getVersion())))
                {
                        ilUtil::makeDirParents($this->getDirectory($this->getVersion()));
                }
 
                $file = $this->getDirectory($this->getVersion())."/".$a_filename;
                //move_uploaded_file($a_upload_file, $file);
                ilUtil::moveUploadedFile($a_upload_file, $a_filename, $file, $this->raise_upload_error);
                
                $this->handleQuotaUpdate($this);
                
                // create preview?
                if (!$a_prevent_preview)
                {
                        $this->createPreview(false);
                }                       
        }

References $file, createPreview(), getDirectory(), getVersion(), handleQuotaUpdate(), ilUtil\makeDirParents(), ilUtil\moveUploadedFile(), and setVersion().

Referenced by addFileVersion(), and replaceFile().

Here is the call graph for this function:

Here is the caller graph for this function:

getUsages()

ilObjFile::getUsages

(

)

get all usages of file object

Definition at line 935 of file class.ilObjFile.php.

        {
                global $ilDB;
 
                // get usages in learning modules
                $q = "SELECT * FROM file_usage WHERE id = ".$ilDB->quote($this->getId(), "integer");
                $us_set = $ilDB->query($q);
                $ret = array();
                while($us_rec = $ilDB->fetchAssoc($us_set))
                {
                        $ret[] = array("type" => $us_rec["usage_type"],
                                "id" => $us_rec["usage_id"],
                                "lang" => $us_rec["usage_lang"],
                                "hist_nr" => $us_rec["usage_hist_nr"]);
                }
 
                return $ret;
        }

References $ilDB, $ret, and ilObject2\getId().

Referenced by beforeDelete(), and handleQuotaUpdate().

Here is the call graph for this function:

Here is the caller graph for this function:

getVersion()

ilObjFile::getVersion

(

)

Definition at line 518 of file class.ilObjFile.php.

        {
                return $this->version;
        }

Referenced by addFileVersion(), deleteVersions(), determineFileSize(), doCloneObject(), doUpdate(), export(), getFile(), getUploadFile(), rollback(), sendFile(), and storeUnzipedFile().

Here is the caller graph for this function:

getVersions()

ilObjFile::getVersions

(

$version_ids = null

)

Gets the file versions for this object.

Parameters

array

$version_ids

The file versions to get. If not specified all versions are returned.

Returns

The file versions.

Definition at line 1113 of file class.ilObjFile.php.

        {
                include_once("./Services/History/classes/class.ilHistory.php");
                $versions = ilHistory::_getEntriesForObject($this->getId(), $this->getType());
                
                if ($version_ids != null && count($version_ids) > 0)
                {
                        foreach ($versions as $index => $version) 
                        {
                                if (!in_array($version["hist_entry_id"], $version_ids, true))
                                {
                                        unset($versions[$index]);
                                }
                        }               
                }
                
                // add custom entries
                foreach ($versions as $index => $version) 
                {
                        $params = $this->parseInfoParams($version);
                        $versions[$index] = array_merge($version, $params);
                }
                
                // sort by version number (hist_entry_id will do for that)
                usort($versions, array($this, "compareVersions"));
                
                return $versions;
        }

References ilHistory\_getEntriesForObject(), ilObject2\getId(), ilObject2\getType(), and parseInfoParams().

Referenced by deleteVersions().

Here is the call graph for this function:

Here is the caller graph for this function:

getXMLZip()

ilObjFile::getXMLZip

(

)

Reimplemented from ilObject.

Definition at line 983 of file class.ilObjFile.php.

        {
                global $ilias;
 
                $zip = PATH_TO_ZIP;
 
                exec($zip.' '.ilUtil::escapeShellArg($this->getDirectory().'/'.$this->getFileName())." ".
                         ilUtil::escapeShellArg($this->getDirectory().'/'.'1.zip'));
 
                return $this->getDirectory().'/1.zip';
        }

References ilObject\$ilias, ilUtil\escapeShellArg(), and getDirectory().

Here is the call graph for this function:

guessFileType()

ilObjFile::guessFileType

(

$a_file = ""

)

Guesses the file type based on the current values returned by getFileType() and getFileExtension().

If getFileType() returns 'application/octet-stream', the file extension is used to guess a more accurate file type.

Definition at line 697 of file class.ilObjFile.php.

                                             {
                
                $path = pathinfo($a_file);
                if ($path["extension"] != "")
                {
                        $filename = $path["basename"];
                }
                else
                {
                        $filename = "dummy.".$this->getFileExtension();
                }
                include_once("./Services/Utilities/classes/class.ilMimeTypeUtil.php");
                $mime = ilMimeTypeUtil::getMimeType($a_file, $filename, $this->getFileType());
                return $mime;
                
/*
                $fileType = $this->getFileType();
                if (strlen($fileType) == 0) {   
                        $fileType = 'application/octet-stream';
                }
 
                // Firefox browser assigns 'application/x-pdf' to PDF files, but
                // it can only handle them if the have the mime-type 'application/pdf'.
                if ($fileType == 'application/x-pdf')
                {
                        $fileType = 'application/pdf';
                }
 
                if ($fileType == 'application/octet-stream')
                {
                        $fileExtension = $this->getFileExtension();
                        $mimeArray = array(
                                'mpeg' => 'video/mpeg',
                                'mp3' => 'audio/mpeg',
                                'pdf' => 'application/pdf',
                                'gif' => 'image/gif',
                                'jpg' => 'image/jpg',
                                'png' => 'image/png',
                                'htm' => 'text/html',
                                'html' => 'text/html',
                                'wma' => 'video/x-ms-wma',
                                'wmv' => 'video/x-ms-wmv',
                                'swf' => 'application/x-shockwave-flash',
                        );
                        if (array_key_exists($fileExtension, $mimeArray))
                        {
                                $fileType = $mimeArray[$fileExtension];
                        }
                }
                return $fileType;
*/
        }

References $filename, $path, getFileType(), and ilMimeTypeUtil\getMimeType().

Referenced by sendFile(), and updateWithVersion().

Here is the call graph for this function:

Here is the caller graph for this function:

handleQuotaUpdate()

static ilObjFile::handleQuotaUpdate ( ilObjFile  $a_file )

staticprotected

Definition at line 1288 of file class.ilObjFile.php.

        {                               
                include_once "Services/MediaObjects/classes/class.ilObjMediaObject.php";        
                $mob = new ilObjMediaObject();
                
                // file itself could be workspace item
                $parent_obj_ids = array($a_file->getId());
                
                foreach($a_file->getUsages() as $item)
                {                                                                               
                        $parent_obj_id = $mob->getParentObjectIdForUsage($item);
                        if($parent_obj_id && 
                                !in_array($parent_obj_id, $parent_obj_ids))
                        {                                       
                                $parent_obj_ids[]= $parent_obj_id;
                        }                                               
                }
                
                include_once "Services/DiskQuota/classes/class.ilDiskQuotaHandler.php";
                ilDiskQuotaHandler::handleUpdatedSourceObject($a_file->getType(), 
                        $a_file->getId(),
                        $a_file->getDiskUsage(), 
                        $parent_obj_ids);       
        }

References getDiskUsage(), ilObject2\getId(), ilObject2\getType(), getUsages(), and ilDiskQuotaHandler\handleUpdatedSourceObject().

Referenced by _deleteAllUsages(), _saveUsage(), deleteVersions(), doDelete(), doUpdate(), and getUploadFile().

Here is the call graph for this function:

Here is the caller graph for this function:

hasRating()

ilObjFile::hasRating

(

)

Definition at line 1346 of file class.ilObjFile.php.

        {
                return $this->rating;
        }

References $rating.

Referenced by doCloneObject(), and doUpdate().

Here is the caller graph for this function:

initFileStorage()

ilObjFile::initFileStorage

(

)

init file storage object

@access public

Definition at line 1030 of file class.ilObjFile.php.

        {
                $this->file_storage = new ilFSStorageFile($this->getId());
                return true;
        }

References ilObject2\getId().

Referenced by __construct(), createProperties(), doRead(), and getDirectory().

Here is the call graph for this function:

Here is the caller graph for this function:

initType()

ilObjFile::initType

(

)

Reimplemented from ilObject2.

Definition at line 48 of file class.ilObjFile.php.

        {
                $this->type = "file";
        }

isHidden()

ilObjFile::isHidden

(

)

Returns true, if this file should be hidden in the repository view.

Definition at line 685 of file class.ilObjFile.php.

                            {
                require_once 'Modules/File/classes/class.ilObjFileAccess.php';
                return ilObjFileAccess::_isFileHidden($this->getTitle());
        }

References ilObjFileAccess\_isFileHidden(), and ilObject2\getTitle().

Referenced by addNewsNotification().

Here is the call graph for this function:

Here is the caller graph for this function:

isInline()

ilObjFile::isInline

(

)

Returns true, if this file should be displayed inline in a browser window.

This is especially useful for PDF documents, HTML pages, and for images which are directly supported by the browser.

Definition at line 678 of file class.ilObjFile.php.

                            {
                require_once 'Modules/File/classes/class.ilObjFileAccess.php';
                return ilObjFileAccess::_isFileInline($this->getTitle());
        }

References ilObjFileAccess\_isFileInline(), and ilObject2\getTitle().

Referenced by sendFile().

Here is the call graph for this function:

Here is the caller graph for this function:

parseInfoParams()

ilObjFile::parseInfoParams

(

$entry

)

Parses the info parameters ("info_params") of the specified history entry.

Parameters

array

$entry

The history entry.

Returns

array Returns an array containing the "filename" and "version" contained within the "info_params".

Definition at line 1260 of file class.ilObjFile.php.

        {
                $data = preg_split("/(.*),(.*)/", $entry["info_params"], 0, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);
                
                // bugfix: first created file had no version number
                // this is a workaround for all files created before the bug was fixed
                if (empty($data[1]))
                        $data[1] = "1";
                
                $result = array("filename" => $data[0], "version" => $data[1], "rollback_version" => "", "rollback_user_id" => "");
 
                // if rollback, the version contains the rollback version as well
                if ($entry["action"] == "rollback")
                {
                        $tokens = explode("|", $result["version"]);
                        if (count($tokens) > 1)
                        {
                                $result["version"] = $tokens[0];
                                $result["rollback_version"] = $tokens[1];
                                
                                if (count($tokens) > 2)
                                        $result["rollback_user_id"] = $tokens[2];
                        }
                }
                
                return $result;
        }

References $data, $result, and PREG_SPLIT_DELIM_CAPTURE.

Referenced by determineFileSize(), getFile(), getSpecificVersion(), getVersions(), and sendFile().

Here is the caller graph for this function:

raiseUploadError()

ilObjFile::raiseUploadError

(

$a_raise = true

)

Definition at line 202 of file class.ilObjFile.php.

        {
                $this->raise_upload_error = $a_raise;
        }

replaceFile()

ilObjFile::replaceFile	(		$a_upload_file,
			$a_filename
	)

replace file with new file

Definition at line 232 of file class.ilObjFile.php.

        {
                $this->getUploadFile($a_upload_file, $a_filename, true);
                
                require_once("./Services/History/classes/class.ilHistory.php");
                ilHistory::_createEntry(
                        $this->getId(),
                        "replace",
                        $a_filename.",".$this->getVersion()
                );
                $this->setFilename($a_filename);
                $this->addNewsNotification("file_updated");
                
                // create preview
                $this->createPreview(true);
        }

References ilHistory\_createEntry(), addNewsNotification(), createPreview(), ilObject2\getId(), and getUploadFile().

Here is the call graph for this function:

rollback()

ilObjFile::rollback

(

$version_id

)

Makes the specified version the current one and returns theSummary of rollbackVersion.

Parameters

int

$version_id

The id of the version to make the current one.

Returns

array The new actual version.

Definition at line 1173 of file class.ilObjFile.php.

        {
                global $ilDB, $ilUser;
                
                $source = $this->getSpecificVersion($version_id);
                if ($source === false)
                {
                        $this->ilErr->raiseError($this->lng->txt("obj_not_found"), $this->ilErr->MESSAGE);
                }
                
                // get the new version number
                $new_version_nr = $this->getVersion() + 1;
                
                // copy file 
                $source_path = $this->getDirectory($source["version"]) . "/" . $source["filename"];
                $dest_dir = $this->getDirectory($new_version_nr);
                if (@!is_dir($dest_dir))
                        ilUtil::makeDir($dest_dir);
 
                copy($source_path, $dest_dir . "/" . $source["filename"]);
                
                // create new history entry based on the old one
                include_once("./Services/History/classes/class.ilHistory.php");
                ilHistory::_createEntry(
                        $this->getId(), 
                        "rollback", 
                        $source["filename"] . "," . $new_version_nr . "|" . $source["version"] . "|" . $ilUser->getId());
                
                // get id of newest entry
                $new_version = $this->getSpecificVersion($ilDB->getLastInsertId());
                
                // change user back to the original uploader
                ilHistory::_changeUserId($new_version["hist_entry_id"], $source["user_id"]);
                
                // update this file with the new version
                $this->updateWithVersion($new_version);
                
                $this->addNewsNotification("file_updated");
                
                return $new_version;
        }

References $ilDB, $ilUser, ilHistory\_changeUserId(), ilHistory\_createEntry(), addNewsNotification(), copy(), getDirectory(), ilObject2\getId(), getSpecificVersion(), getVersion(), ilUtil\makeDir(), and updateWithVersion().

Here is the call graph for this function:

sendFile()

ilObjFile::sendFile

(

$a_hist_entry_id = null

)

Definition at line 610 of file class.ilObjFile.php.

        {       
                if (is_null($a_hist_entry_id))
                {
                        $file = $this->getDirectory($this->getVersion())."/".$this->getFileName();
 
                        // if not found lookup for file in file object's main directory for downward c  ompability
                        if (@!is_file($file))
                        {
                                $file = $this->getDirectory()."/".$this->getFileName();
                        }
                }
                else
                {
                        require_once("./Services/History/classes/class.ilHistory.php");
                        $entry = ilHistory::_getEntryByHistoryID($a_hist_entry_id);
                        
                        if ($entry === false)
                        {
                                echo "3";return false;
                        }
 
                        $data = $this->parseInfoParams($entry);
                        $file = $this->getDirectory($data["version"])."/".$data["filename"];
                        
                        // if not found lookup for file in file object's main directory for downward compability
                        if (@!is_file($file))
                        {
                                $file = $this->getDirectory()."/".$data[0];
                        }
 
                        // BEGIN WebDAV removed duplicated code
                        // END WebDAV removed duplicated code
                }
 
                if (@is_file($file))
                {
                        global $ilClientIniFile;
                        
                        // also returning the 'real' filename if a history file is delivered
                        if ($ilClientIniFile->readVariable('file_access','download_with_uploaded_filename') != '1' && is_null($a_hist_entry_id))
                        {
                                ilUtil::deliverFile($file, $this->getTitle(), $this->guessFileType($file), $this->isInline());
                        }
                        else
                        {
                                ilUtil::deliverFile($file, basename($file), $this->guessFileType($file), $this->isInline());
                        }
                        return true;
                }
 
                return false;
        }

References $data, $file, ilHistory\_getEntryByHistoryID(), ilUtil\deliverFile(), getDirectory(), getFileName(), ilObject2\getTitle(), getVersion(), guessFileType(), isInline(), and parseInfoParams().

Here is the call graph for this function:

setFileName()

ilObjFile::setFileName

(

$a_name

)

set filename

Definition at line 444 of file class.ilObjFile.php.

        {
                $this->filename = $a_name;
        }

Referenced by doRead(), and updateWithVersion().

Here is the caller graph for this function:

setFileSize()

ilObjFile::setFileSize

(

$a_size

)

Definition at line 467 of file class.ilObjFile.php.

        {
                $this->filesize = $a_size;
        }

Referenced by determineFileSize(), and doRead().

Here is the caller graph for this function:

setFileType()

ilObjFile::setFileType

(

$a_type

)

Definition at line 454 of file class.ilObjFile.php.

        {
                global $ilLog;
                
                
                $this->filetype = $a_type;
        }

References $ilLog.

Referenced by doMDUpdateListener(), doRead(), and updateWithVersion().

Here is the caller graph for this function:

setMode()

ilObjFile::setMode

(

$a_mode

)

mode is object or filelist

Parameters

string

$a_mode

mode

Definition at line 528 of file class.ilObjFile.php.

        {
                $this->mode = $a_mode;
        }

Referenced by doRead().

Here is the caller graph for this function:

setRating()

ilObjFile::setRating

(

$a_value

)

Definition at line 1341 of file class.ilObjFile.php.

        {
                $this->rating = (bool)$a_value;
        }

Referenced by doRead().

Here is the caller graph for this function:

setVersion()

ilObjFile::setVersion

(

$a_version

)

Definition at line 513 of file class.ilObjFile.php.

        {
                $this->version = $a_version;
        }

Referenced by deleteVersions(), doRead(), getUploadFile(), storeUnzipedFile(), and updateWithVersion().

Here is the caller graph for this function:

storeUnzipedFile()

ilObjFile::storeUnzipedFile	(		$a_upload_file,
			$a_filename
	)

storeUnzipedFile

Stores Files unzipped from uploaded archive in filesystem

Parameters

string	$a_upload_file
string	$a_filename

Definition at line 1044 of file class.ilObjFile.php.

                {
                        $this->setVersion($this->getVersion() + 1);
 
                        if (@!is_dir($this->getDirectory($this->getVersion())))
                        {
                                ilUtil::makeDir($this->getDirectory($this->getVersion()));
                        }
 
                        $file = $this->getDirectory($this->getVersion())."/".$a_filename;
                        //move_uploaded_file($a_upload_file, $file);
                        rename($a_upload_file,  $file);
                        
                        // create preview
                        $this->createPreview();
        }

References $file, createPreview(), getDirectory(), getVersion(), ilUtil\makeDir(), and setVersion().

Here is the call graph for this function:

updateWithVersion()

ilObjFile::updateWithVersion (   $version )

protected

Updates the file object with the specified file version.

Parameters

array

$version

The version to update the file object with.

Definition at line 1220 of file class.ilObjFile.php.

        {
                // update title (checkFileExtension must be called before setFileName!)
                $this->setTitle($this->checkFileExtension($version["filename"], $this->getTitle()));
                
                $this->setVersion($version["version"]);
                $this->setFileName($version["filename"]);
                
                // evaluate mime type (reset file type before)
                $this->setFileType("");
                $this->setFileType($this->guessFileType($version["filename"]));
                
                // set filesize
                $this->determineFileSize();
 
                $this->update();        
                
                // refresh preview
                $this->createPreview(true);
        }

References checkFileExtension(), createPreview(), determineFileSize(), ilObject2\getTitle(), guessFileType(), setFileName(), setFileType(), ilObject2\setTitle(), setVersion(), and ilObject2\update().

Referenced by deleteVersions(), and rollback().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

$file_storage

ilObjFile::$file_storage = null

private

Definition at line 27 of file class.ilObjFile.php.

Referenced by _lookupAbsolutePath().

$filemaxsize

ilObjFile::$filemaxsize = "20000000"

Definition at line 22 of file class.ilObjFile.php.

$filename

ilObjFile::$filename

Definition at line 20 of file class.ilObjFile.php.

Referenced by _lookupAbsolutePath(), getFileName(), and guessFileType().

$filetype

ilObjFile::$filetype

Definition at line 21 of file class.ilObjFile.php.

Referenced by getFileType().

$mode

ilObjFile::$mode = "object"

Definition at line 24 of file class.ilObjFile.php.

Referenced by getMode().

$raise_upload_error

ilObjFile::$raise_upload_error

Definition at line 23 of file class.ilObjFile.php.

$rating

ilObjFile::$rating

protected

Definition at line 25 of file class.ilObjFile.php.

Referenced by hasRating().

---

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

• Modules/File/classes/class.ilObjFile.php