Access class for file objects. More...

Inheritance diagram for ilObjFileAccess:

Collaboration diagram for ilObjFileAccess:

Public Member Functions

canBeDelivered (ilWACPath $ilWACPath)

_lookupVersion ($a_id)

lookup version More...

_lookupFileSize ($a_id)

lookup size More...

Public Member Functions inherited from ilObjectAccess

_checkAccess ($a_cmd, $a_permission, $a_ref_id, $a_obj_id, $a_user_id="")

Checks wether a user may invoke a command or not (this method is called by ilAccessHandler::checkAccess) More...

_checkCondition ($a_obj_id, $a_operator, $a_value, $a_usr_id)

check condition More...

canBeDelivered (ilWACPath $ilWACPath)

Parameters

ilWACPath $ilWACPath

Returns: bool

More...

canBeDelivered (ilWACPath $ilWACPath)

Static Public Member Functions
static	_getCommands ()
	get commands More...

static	_checkGoto ($a_target)
	check whether goto script will succeed More...

static	_lookupFileData ($a_id)
	looks up the file_data for the file object with the specified object id as an associative array. More...

static	_lookupVersion ($a_id)
	lookup version More...

static	_lookupFileSize ($a_id)
	Quickly looks up the file size from the database and returns the number of bytes. More...

static	_lookupFileSizeFromFilesystem ($a_id)
	Looks up the file size by retrieving it from the filesystem. More...

static	_lookupSuffix ($a_id)
	lookup suffix More...

static	_lookupDiskUsage ($a_id)
	Returns the number of bytes used on the harddisk by the file object with the specified object id. More...

static	_isFileInline ($a_file_name)
	Returns true, if the specified file shall be displayed inline in the browser. More...

static	_getFileExtension ($a_file_name)
	Gets the file extension of the specified file name. More...

static	_isFileHidden ($a_file_name)
	Returns true, if a file with the specified name, is usually hidden from the user. More...

static	_appendNumberOfCopyToFilename ($a_file_name, $nth_copy=null, $a_handle_extension=false)
	Appends the text " - Copy" to a filename in the language of the current user. More...

static	_getPermanentDownloadLink ($ref_id)
	Gets the permanent download link for the file. More...

static	_preloadData ($a_obj_ids, $a_ref_ids)

static	getListGUIData ($a_obj_id)

Static Public Member Functions inherited from ilObjectAccess
static	_getCommands ()
	get commands More...

static	_checkGoto ($a_target)
	check whether goto script will succeed More...

static	_isOffline ($a_obj_id)
	Type-specific implementation of general status, has to be overwritten if object type does not support centralized offline handling. More...

static	_preloadData ($a_obj_ids, $a_ref_ids)
	Preload data. More...

Static Protected Attributes
static	$_inlineFileExtensionsArray
	Contains an array of extensions separated by space. More...

static	$preload_list_gui_data

Detailed Description

Access class for file objects.

Author: Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e; Stefan Born stefa.nosp@m.n.bo.nosp@m.rn@ph.nosp@m.zh.c.nosp@m.h

Version: $Id$

Definition at line 17 of file class.ilObjFileAccess.php.

Member Function Documentation

◆ _appendNumberOfCopyToFilename()

static ilObjFileAccess::_appendNumberOfCopyToFilename	(	$a_file_name,
		$nth_copy = `null`,
		$a_handle_extension = `false`
	)

static

Appends the text " - Copy" to a filename in the language of the current user.

If the provided $nth_copy parameter is greater than 1, then is appended in round brackets. If $nth_copy parameter is null, then the function determines the copy number on its own.

If this function detects, that the filename already ends with " - Copy", or with "- Copy ($nth_copy), it only appends the number of the copy to the filename. This function retains the extension of the filename. Examples: - Calling ilObjFileAccess::_appendCopyToTitle('Hello.txt', 1) returns: "Hello - Copy.txt". - Calling ilObjFileAccess::_appendCopyToTitle('Hello.txt', 2) returns: "Hello - Copy (2).txt". - Calling ilObjFileAccess::_appendCopyToTitle('Hello - Copy (3).txt', 2) returns: "Hello - Copy (2).txt". - Calling ilObjFileAccess::_appendCopyToTitle('Hello - Copy (3).txt', null) returns: "Hello - Copy (4).txt".

Definition at line 356 of file class.ilObjFileAccess.php.

    {
        global $DIC;
        $lng = $DIC['lng'];
 
        $filenameWithoutExtension = $a_file_name;
 
        $extension = null;
        if ($a_handle_extension) {
            // Get the extension and the filename without the extension
            $extension = ilObjFileAccess::_getFileExtension($a_file_name);
            if (strlen($extension) > 0) {
                $extension = '.' . $extension;
                $filenameWithoutExtension = substr($a_file_name, 0, -strlen($extension));
            }
        }
 
        // create a regular expression from the language text copy_n_of_suffix, so that
        // we can match it against $filenameWithoutExtension, and retrieve the number of the copy.
        // for example, if copy_n_of_suffix is 'Copy (%1s)', this creates the regular
        // expression '/ Copy \\‍([0-9]+)\\‍)$/'.
        $nthCopyRegex = preg_replace('/([\^$.\[\]|()?*+{}])/', '\\\\${1}', ' '
            . $lng->txt('copy_n_of_suffix'));
        $nthCopyRegex = '/' . preg_replace('/%1\\\\\$s/', '([0-9]+)', $nthCopyRegex) . '$/';
 
        // Get the filename without any previously added number of copy.
        // Determine the number of copy, if it has not been specified.
        if (preg_match($nthCopyRegex, $filenameWithoutExtension, $matches)) {
            // this is going to be at least the third copy of the filename
            $filenameWithoutCopy = substr($filenameWithoutExtension, 0, -strlen($matches[0]));
            if ($nth_copy == null) {
                $nth_copy = $matches[1] + 1;
            }
        } else {
            if (substr($filenameWithoutExtension, -strlen(' ' . $lng->txt('copy_of_suffix')))
                == ' ' . $lng->txt('copy_of_suffix')
            ) {
                // this is going to be the second copy of the filename
                $filenameWithoutCopy = substr($filenameWithoutExtension, 0, -strlen(' '
                    . $lng->txt('copy_of_suffix')));
                if ($nth_copy == null) {
                    $nth_copy = 2;
                }
            } else {
                // this is going to be the first copy of the filename
                $filenameWithoutCopy = $filenameWithoutExtension;
                if ($nth_copy == null) {
                    $nth_copy = 1;
                }
            }
        }
 
        // Construct the new filename
        if ($nth_copy > 1) {
            // this is at least the second copy of the filename, append " - Copy ($nth_copy)"
            $newFilename = $filenameWithoutCopy . sprintf(' '
                    . $lng->txt('copy_n_of_suffix'), $nth_copy)
                . $extension;
        } else {
            // this is the first copy of the filename, append " - Copy"
            $newFilename = $filenameWithoutCopy . ' ' . $lng->txt('copy_of_suffix') . $extension;
        }
 
        return $newFilename;
    }

References $DIC, $lng, and _getFileExtension().

Referenced by ilObject\appendCopyInfo(), and ilContainerGUI\performPasteIntoMultipleObjectsObject().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _checkGoto()

static ilObjFileAccess::_checkGoto ( $a_target )

static

check whether goto script will succeed

Reimplemented from ilObjectAccess.

Definition at line 116 of file class.ilObjFileAccess.php.

    {
        global $DIC;
        $ilAccess = $DIC['ilAccess'];
 
        $t_arr = explode("_", $a_target);
 
        // personal workspace context: do not force normal login
        if (isset($t_arr[2]) && $t_arr[2] == "wsp") {
            include_once "Services/PersonalWorkspace/classes/class.ilSharedResourceGUI.php";
 
            return ilSharedResourceGUI::hasAccess($t_arr[1]);
        }
 
        if ($t_arr[0] != "file" || ((int) $t_arr[1]) <= 0) {
            return false;
        }
 
        if ($ilAccess->checkAccess("visible", "", $t_arr[1])
            || $ilAccess->checkAccess("read", "", $t_arr[1])
        ) {
            return true;
        }
 
        return false;
    }

References $DIC, and ilSharedResourceGUI\hasAccess().

Here is the call graph for this function:

◆ _getCommands()

static ilObjFileAccess::_getCommands ( )

static

get commands

this method returns an array of all possible commands/permission combinations

example: $commands = array ( array("permission" => "read", "cmd" => "view", "lang_var" => "show"), array("permission" => "write", "cmd" => "edit", "lang_var" => "edit"), );

Reimplemented from ilObjectAccess.

Definition at line 89 of file class.ilObjFileAccess.php.

    {
        $commands = array();
        $commands[] = array(
            "permission" => "read",
            "cmd" => "sendfile",
            "lang_var" => "download",
            "default" => true,
        );
        $commands[] = array(
            "permission" => "write",
            "cmd" => "versions",
            "lang_var" => "versions",
        );
        $commands[] = array(
            "permission" => "write",
            "cmd" => "edit",
            "lang_var" => "settings",
        );
 
        return $commands;
    }

Referenced by ilObjFileListGUI\init().

Here is the caller graph for this function:

◆ _getFileExtension()

static ilObjFileAccess::_getFileExtension ( $a_file_name )

static

Gets the file extension of the specified file name.

The file name extension is converted to lower case before it is returned.

For example, for the file name "HELLO.MP3", this function returns "mp3".

A file name extension can have multiple parts. For the file name "hello.tar.gz", this function returns "gz".

Parameters

string $a_file_name The file name

Definition at line 301 of file class.ilObjFileAccess.php.

    {
        if (preg_match('/\.([a-z0-9]+)\z/i', $a_file_name, $matches) == 1) {
            return strtolower($matches[1]);
        } else {
            return '';
        }
    }

Referenced by _appendNumberOfCopyToFilename(), _isFileInline(), _lookupSuffix(), ilObjFile\checkFileExtension(), ilObjFile\getFileExtension(), ilObjFileListGUI\getProperties(), ilObjFileGUI\save(), and ilFilePreviewRenderer\supports().

Here is the caller graph for this function:

◆ _getPermanentDownloadLink()

static ilObjFileAccess::_getPermanentDownloadLink ( $ref_id )

static

Gets the permanent download link for the file.

Parameters

int $ref_id

Returns: string

Definition at line 430 of file class.ilObjFileAccess.php.

    {
        return ilLink::_getStaticLink($ref_id, "file", true, "_download");
    }

References ilLink\_getStaticLink().

Referenced by ilObjFileListGUI\getCommandLink(), and ilObjFileGUI\infoScreenForward().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _isFileHidden()

static ilObjFileAccess::_isFileHidden ( $a_file_name )

static

Returns true, if a file with the specified name, is usually hidden from the user.

Filenames starting with '.' are hidden Unix files
Filenames ending with '~' are temporary Unix files
Filenames starting with '~$' are temporary Windows files
The file "Thumbs.db" is a hidden Windows file

Definition at line 320 of file class.ilObjFileAccess.php.

    {
        return substr($a_file_name, 0, 1) == '.' || substr($a_file_name, -1, 1) == '~'
            || substr($a_file_name, 0, 2) == '~$'
            || $a_file_name == 'Thumbs.db';
    }

Referenced by ilItemGroupItems\getAssignableItems(), ilObjectListGUI\getListItemHTML(), ilContainer\getSubItems(), ilObjFile\isHidden(), and ilExportSelectionTableGUI\parseContainer().

Here is the caller graph for this function:

◆ _isFileInline()

static ilObjFileAccess::_isFileInline ( $a_file_name )

static

Returns true, if the specified file shall be displayed inline in the browser.

Definition at line 274 of file class.ilObjFileAccess.php.

    {
        if (self::$_inlineFileExtensionsArray
            === null
        ) {        // the === makes a huge difference, if the array is empty
            require_once 'Services/Administration/classes/class.ilSetting.php';
            $settings = new ilSetting('file_access');
            self::$_inlineFileExtensionsArray = preg_split('/ /', $settings->get('inline_file_extensions'), -1, PREG_SPLIT_NO_EMPTY);
        }
        $extension = self::_getFileExtension($a_file_name);
 
        return in_array($extension, self::$_inlineFileExtensionsArray);
    }

References _getFileExtension().

Referenced by ilObjFileListGUI\getCommandFrame(), ilObjFileListGUI\getIconImageType(), and ilObjFile\isInline().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _lookupDiskUsage()

static ilObjFileAccess::_lookupDiskUsage ( $a_id )

static

Returns the number of bytes used on the harddisk by the file object with the specified object id.

Parameters

int	object id of a file object.

Definition at line 259 of file class.ilObjFileAccess.php.

    {
        include_once('Modules/File/classes/class.ilFSStorageFile.php');
        $fileStorage = new ilFSStorageFile($a_id);
        $dir = $fileStorage->getAbsolutePath();
 
        return ilUtil::dirsize($dir);
    }

References ilUtil\dirsize().

Referenced by ilObjFile\getDiskUsage().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _lookupFileData()

static ilObjFileAccess::_lookupFileData ( $a_id )

static

looks up the file_data for the file object with the specified object id as an associative array.

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $q = "SELECT * FROM file_data WHERE file_id = " . $ilDB->quote($a_id, 'integer');
        $r = $ilDB->query($q);
        $row = $r->fetchRow(ilDBConstants::FETCHMODE_ASSOC);
 
        return $row;
    }

References $DIC, $ilDB, and ilDBConstants\FETCHMODE_ASSOC.

◆ _lookupFileSize() [1/2]

static ilObjFileAccess::_lookupFileSize ( $a_id )

static

Quickly looks up the file size from the database and returns the number of bytes.

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $q = "SELECT file_size FROM file_data WHERE file_id = " . $ilDB->quote($a_id, 'integer');
        $r = $ilDB->query($q);
        $row = $r->fetchRow(ilDBConstants::FETCHMODE_OBJECT);
 
        $size = $row->file_size;
 
        return $size;
    }

References $DIC, $ilDB, $size, and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilObjectXMLWriter\__appendObjectProperties(), ilObjFile\_lookupFileSize(), ilCheckSumOfFileSizesJob\calculateRecursive(), and ilCheckSumOfWorkspaceFileSizesJob\calculateRecursive().

Here is the caller graph for this function:

◆ _lookupFileSize() [2/2]

ilObjFileAccess::_lookupFileSize ( $a_id )

lookup size

Definition at line 44 of file class.ilObjFileAccess.php.

    {
        global $ilDB;
 
        $q = "SELECT * FROM file_data WHERE file_id = " . $ilDB->quote($a_id);
        $r = $ilDB->query($q);
        $row = $r->fetchRow(ilDBConstants::FETCHMODE_OBJECT);
        
        include_once('Services/Migration/DBUpdate_904/classes/class.ilFSStorageFile.php');
        $fss = new ilFSStorageFile($a_id);
        $file = $fss->getAbsolutePath() . '/' . $row->file_name;
 
        if (@!is_file($file)) {
            $version_subdir = "/" . sprintf("%03d", ilObjFileAccess::_lookupVersion($a_id));
            $file = $fss->getAbsolutePath() . '/' . $version_subdir . '/' . $row->file_name;
        }
 
        if (is_file($file)) {
            $size = filesize($file);
        } else {
            $size = 0;
        }
        
        return $size;
    }

References $ilDB, $size, _lookupVersion(), and ilDBConstants\FETCHMODE_OBJECT.

Here is the call graph for this function:

◆ _lookupFileSizeFromFilesystem()

static ilObjFileAccess::_lookupFileSizeFromFilesystem ( $a_id )

static

Looks up the file size by retrieving it from the filesystem.

This function runs much slower than _lookupFileSize()! Use this function only, to update the data in the database. For example, if the file size in the database has become inconsistent for some reason.

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

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $q = "SELECT * FROM file_data WHERE file_id = " . $ilDB->quote($a_id, 'integer');
        $r = $ilDB->query($q);
        $row = $r->fetchRow(ilDBConstants::FETCHMODE_OBJECT);
 
        require_once('Modules/File/classes/class.ilFSStorageFile.php');
        $fss = new ilFSStorageFile($a_id);
        $file = $fss->getAbsolutePath() . '/' . $row->file_name;
 
        if (@!is_file($file)) {
            $version_subdir = "/" . sprintf("%03d", ilObjFileAccess::_lookupVersion($a_id));
            $file = $fss->getAbsolutePath() . '/' . $version_subdir . '/' . $row->file_name;
        }
 
        if (is_file($file)) {
            $size = filesize($file);
        } else {
            $size = 0;
        }
 
        return $size;
    }

References $DIC, $ilDB, $size, _lookupVersion(), and ilDBConstants\FETCHMODE_OBJECT.

Here is the call graph for this function:

◆ _lookupSuffix()

static ilObjFileAccess::_lookupSuffix ( $a_id )

static

lookup suffix

Definition at line 235 of file class.ilObjFileAccess.php.

    {
        include_once('Modules/File/classes/class.ilFSStorageFile.php');
 
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        // BEGIN WebDAV: Filename suffix is determined by file title
        $q = "SELECT * FROM object_data WHERE obj_id = " . $ilDB->quote($a_id, 'integer');
        $r = $ilDB->query($q);
        $row = $r->fetchRow(ilDBConstants::FETCHMODE_OBJECT);
        require_once 'Modules/File/classes/class.ilObjFile.php';
 
        return self::_getFileExtension($row->title);
        // END WebDAV: Filename suffix is determined by file title
    }

References $DIC, $ilDB, _getFileExtension(), and ilDBConstants\FETCHMODE_OBJECT.

Referenced by ilObjectXMLWriter\__appendObjectProperties().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _lookupVersion() [1/2]

static ilObjFileAccess::_lookupVersion ( $a_id )

static

lookup version

Definition at line 164 of file class.ilObjFileAccess.php.

    {
        global $DIC;
        $ilDB = $DIC['ilDB'];
 
        $q = "SELECT version FROM file_data WHERE file_id = " . $ilDB->quote($a_id, 'integer');
        $r = $ilDB->query($q);
        $row = $r->fetchRow(ilDBConstants::FETCHMODE_OBJECT);
 
        $striped = ilUtil::stripSlashes($row->version);
 
        return $striped > 0 ? $striped : 1;
    }

References $DIC, $ilDB, ilDBConstants\FETCHMODE_OBJECT, and ilUtil\stripSlashes().

Referenced by ilObjectXMLWriter\__appendObjectProperties(), _lookupFileSize(), _lookupFileSizeFromFilesystem(), and ilObjFile\_lookupVersion().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ _lookupVersion() [2/2]

ilObjFileAccess::_lookupVersion ( $a_id )

lookup version

Definition at line 30 of file class.ilObjFileAccess.php.

    {
        global $ilDB;
 
        $q = "SELECT * FROM file_data WHERE file_id = " . $ilDB->quote($a_id);
        $r = $ilDB->query($q);
        $row = $r->fetchRow(ilDBConstants::FETCHMODE_OBJECT);
 
        return $row->version;
    }

References $ilDB, and ilDBConstants\FETCHMODE_OBJECT.

◆ _preloadData()

static ilObjFileAccess::_preloadData	(	$a_obj_ids,
		$a_ref_ids
	)

static

Parameters

array	$a_obj_ids
int[]	$a_ref_ids

Reimplemented from ilObjectAccess.

Definition at line 440 of file class.ilObjFileAccess.php.

    {
        global $DIC;
 
        self::$preload_list_gui_data = array();
 
        $set = $DIC->database()->query("SELECT obj_id,max(hdate) latest" . " FROM history"
            . " WHERE obj_type = " . $DIC->database()->quote("file", "text") . " AND "
            . $DIC->database()->in("obj_id", $a_obj_ids, "", "integer") . " GROUP BY obj_id");
        while ($row = $DIC->database()->fetchAssoc($set)) {
            self::$preload_list_gui_data[$row["obj_id"]]["date"] = $row["latest"];
        }
 
        $set = $DIC->database()->query("SELECT file_size, version, file_id, page_count" . " FROM file_data" . " WHERE "
            . $DIC->database()->in("file_id", $a_obj_ids, "", "integer"));
        while ($row = $DIC->database()->fetchAssoc($set)) {
            self::$preload_list_gui_data[$row["file_id"]]["size"] = $row["file_size"];
            self::$preload_list_gui_data[$row["file_id"]]["version"] = $row["version"];
            self::$preload_list_gui_data[$row["file_id"]]["page_count"] = $row["page_count"];
        }
    }

References $DIC.

◆ canBeDelivered()

ilObjFileAccess::canBeDelivered ( ilWACPath $ilWACPath )

Parameters

\ilWACPath $ilWACPath

Returns: bool

Reimplemented from ilObjectAccess.

Definition at line 47 of file class.ilObjFileAccess.php.

    {
        switch ($ilWACPath->getSecurePathId()) {
            case 'previews':
                $re = '/\/previews\/[\d\/]{0,}\/preview_([\d]{0,})\//uU';
                break;
        }
        preg_match($re, $ilWACPath->getPath(), $matches);
 
        return $this->checkAccessToObjectId($matches[1]);
    }

References ilWACPath\getPath(), and ilWACPath\getSecurePathId().

Here is the call graph for this function:

◆ getListGUIData()

static ilObjFileAccess::getListGUIData ( $a_obj_id )

static

Parameters

$a_obj_id

Returns: array

Definition at line 468 of file class.ilObjFileAccess.php.

    {
        if (isset(self::$preload_list_gui_data[$a_obj_id])) {
            return self::$preload_list_gui_data[$a_obj_id];
        }
    }

Referenced by ilObjFileListGUI\getProperties().

Here is the caller graph for this function:

Field Documentation

◆ $_inlineFileExtensionsArray

ilObjFileAccess::$_inlineFileExtensionsArray

staticprotected

Contains an array of extensions separated by space.

Since this array is needed for every file object displayed on a repository page, we only create it once, and cache it here.

See also: function _isFileInline

Definition at line 71 of file class.ilObjFileAccess.php.

◆ $preload_list_gui_data

ilObjFileAccess::$preload_list_gui_data

staticprotected

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

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

Modules/File/classes/class.ilObjFileAccess.php
Services/Migration/DBUpdate_904/classes/class.ilObjFileAccess.php

Public Member Functions

Static Public Member Functions

Static Protected Attributes

Detailed Description

Member Function Documentation

◆ _appendNumberOfCopyToFilename()

◆ _checkGoto()

◆ _getCommands()

◆ _getFileExtension()

◆ _getPermanentDownloadLink()

◆ _isFileHidden()

◆ _isFileInline()

◆ _lookupDiskUsage()

◆ _lookupFileData()

◆ _lookupFileSize() [1/2]

◆ _lookupFileSize() [2/2]

◆ _lookupFileSizeFromFilesystem()

◆ _lookupSuffix()

◆ _lookupVersion() [1/2]

◆ _lookupVersion() [2/2]

◆ _preloadData()

◆ canBeDelivered()

◆ getListGUIData()

Field Documentation

◆ $_inlineFileExtensionsArray

◆ $preload_list_gui_data