class.ilObjFileAccess.php

Go to the documentation of this file.

<?php
/*
        +-----------------------------------------------------------------------------+
        | ILIAS open source                                                           |
        +-----------------------------------------------------------------------------+
        | Copyright (c) 1998-2006 ILIAS open source, University of Cologne            |
        |                                                                             |
        | This program is free software; you can redistribute it and/or               |
        | modify it under the terms of the GNU General Public License                 |
        | as published by the Free Software Foundation; either version 2              |
        | of the License, or (at your option) any later version.                      |
        |                                                                             |
        | This program is distributed in the hope that it will be useful,             |
        | but WITHOUT ANY WARRANTY; without even the implied warranty of              |
        | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the               |
        | GNU General Public License for more details.                                |
        |                                                                             |
        | You should have received a copy of the GNU General Public License           |
        | along with this program; if not, write to the Free Software                 |
        | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA. |
        +-----------------------------------------------------------------------------+
*/

include_once("classes/class.ilObjectAccess.php");

class ilObjFileAccess extends ilObjectAccess
{
        // BEGIN WebDAV cache inline file extensions
        protected static $_inlineFileExtensionsArray;
        // END WebDAV cache inline file extensions


        function _getCommands()
        {
                $commands = array();
                $commands[] = array("permission" => "read", "cmd" => "sendfile", "lang_var" => "download","default" => true);
                $commands[] = array("permission" => "write", "cmd" => "edit", "lang_var" => "edit");
                $commands[] = array("permission" => "write", "cmd" => "versions", "lang_var" => "versions");
                
                return $commands;
        }
        
        function _checkGoto($a_target)
        {
                global $ilAccess;
                
                $t_arr = explode("_", $a_target);

                if ($t_arr[0] != "file" || ((int) $t_arr[1]) <= 0)
                {
                        return false;
                }

                if ($ilAccess->checkAccess("visible", "", $t_arr[1]))
                {
                        return true;
                }
                return false;
        }

        function _lookupFileData($a_id)
        {
                global $ilDB;

                $q = "SELECT * FROM file_data WHERE file_id = ".$ilDB->quote($a_id ,'integer');
                $r = $ilDB->query($q);
                $row = $r->fetchRow(DB_FETCHMODE_ASSOC);

                return $row;
        }

        function _lookupVersion($a_id)
        {
                global $ilDB;

                $q = "SELECT version 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->version);
        }

        public static function _lookupFileSize($a_id)
        {
                global $ilDB;

                $q = "SELECT file_size FROM file_data WHERE file_id = ".$ilDB->quote($a_id ,'integer');
                $r = $ilDB->query($q);
                $row = $r->fetchRow(DB_FETCHMODE_OBJECT);
                
                $size = $row->file_size;
                
                return $size;
        }

        public static function _lookupFileSizeFromFilesystem($a_id)
        {
                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);
        
                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;
        }


        function _lookupSuffix($a_id)
        {
                include_once('Modules/File/classes/class.ilFSStorageFile.php');
                
                global $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(DB_FETCHMODE_OBJECT);
                require_once 'Modules/File/classes/class.ilObjFile.php';
                return self::_getFileExtension($row->title);
                // END WebDAV: Filename suffix is determined by file title
        }

        function _lookupDiskUsage($a_id)
        {
                include_once('Modules/File/classes/class.ilFSStorageFile.php');
                $fileStorage = new ilFSStorageFile($a_id);
                $dir = $fileStorage->getAbsolutePath();
                return ilUtil::dirsize($dir);
        }
        
        // BEGIN WebDAV: Get file extension, determine if file is inline, guess file type.
        public static function _isFileInline($a_file_name)
        {
                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);
        }
        public static function _getFileExtension($a_file_name) 
        {
                if (preg_match('/\.([a-z0-9]+)\z/i',$a_file_name,$matches) == 1)
                {
                        return strtolower($matches[1]);
                }
                else
                {
                        return '';
                }
        }

        public static function _isFileHidden($a_file_name) 
        {
                return substr($a_file_name,0,1) == '.' ||
                        substr($a_file_name,-1,1) == '~' ||
                        substr($a_file_name,0,2) == '~$' ||
                         $a_file_name == 'Thumbs.db'; 
        }
        // END WebDAV: Get file extension, determine if file is inline, guess file type.
        
        public static function _appendNumberOfCopyToFilename($a_file_name, $nth_copy = null)
        {
                global $lng;
                
                // 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));
                }
                else
                {
                        $filenameWithoutExtension= $a_file_name;
                }
                
                // 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;
        }
}

?>