Inheritance diagram for ilObjFileDAV:

Collaboration diagram for ilObjFileDAV:

Public Member Functions
	__construct (ilObjFile $a_obj, ilWebDAVRepositoryHelper $repo_helper, ilWebDAVObjDAVHelper $dav_helper)
	ilObjFileDAV represents the WebDAV-Interface to an ILIAS-Object More...

	put ($data)
	Replaces the contents of the file. More...

	get ()
	Returns the data. More...

	getName ()
	Returns title of file object. More...

	getContentType ()
	Returns the mime-type for a file. More...

	getETag ()
	Returns the ETag for a file. More...

	getSize ()
	Returns the size of the node, in bytes. More...

	setName ($a_name)

	handleFileUpload ($a_data, $a_file_action)
	Handle uploaded file. More...

Public Member Functions inherited from ilObjectDAV
	__construct (ilObject $a_obj, ilWebDAVRepositoryHelper $repo_helper, ilWebDAVObjDAVHelper $dav_helper)
	Constructor for DAV Object. More...

	getRefId ()
	Returns the ref id of this object. More...

	getObjectId ()
	Returns the object id of this object. More...

	getLastModified ()
	Returns the last modification time as a unix timestamp. More...

	delete ()
	Deletes the current node. More...

	setName ($a_name)
	Renames the node. More...

	getName ()
	SabreDAV interface function . More...

	getObject ()
	Returns ILIAS Object. More...

Protected Member Functions
	uploadFile ($a_data, string $file_dest_path)
	Write given data (as string) to the given file. More...

	getPathToDirectory ()

	getPathToFile ()
	This method is called in 2 use cases: More...

	checkForVirus (string $file_dest_path)

	setObjValuesForNewFileVersion ()
	Set object values for a new file version. More...

	createHistoryAndNotificationForObjUpdate ($a_action)
	Create history entry and a news notification for file object update. More...

	deleteObjOrVersion ()
	Delete an object if there is no other version in it otherwise delete version. More...

Protected Attributes
	$obj

	$versioning_enabled

Protected Attributes inherited from ilObjectDAV
	$ref_id

	$obj

	$repo_helper

	$dav_helper

Detailed Description

Class ilObjFileDAV.

Implementation for ILIAS File Objects represented as WebDAV File Objects

Author: Raphael Heer rapha.nosp@m.el.h.nosp@m.eer@h.nosp@m.slu..nosp@m.ch $Id$

\DAV\IFile

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

Constructor & Destructor Documentation

◆ __construct()

ilObjFileDAV::__construct	(	ilObjFile	$a_obj,
		ilWebDAVRepositoryHelper	$repo_helper,
		ilWebDAVObjDAVHelper	$dav_helper
	)

ilObjFileDAV represents the WebDAV-Interface to an ILIAS-Object

So an ILIAS is needed in the constructor. Otherwise this object would be useless.

Parameters

ilObjFile	$a_obj
ilWebDAVRepositoryHelper	$repo_helper
ilWebDAVObjDAVHelper	$dav_helper

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

    {
        $settings = new ilSetting('file_access');
        $this->versioning_enabled = (bool) $settings->get('webdav_versioning_enabled', true);
        parent::__construct($a_obj, $repo_helper, $dav_helper);
    }

References ilObjectDAV\$dav_helper, ilObjectDAV\$repo_helper, and ILIAS\GlobalScreen\Provider\__construct().

Here is the call graph for this function:

Member Function Documentation

◆ checkForVirus()

ilObjFileDAV::checkForVirus ( string $file_dest_path )

protected

Definition at line 273 of file class.ilObjFileDAV.php.

    {
        $vrs = ilUtil::virusHandling($file_dest_path, '', true);
        // If vrs[0] == false -> virus found
        if ($vrs[0] == false) {
            ilLoggerFactory::getLogger('WebDAV')->error(get_class($this) . ' ' . $this->obj->getTitle() . " -> virus found on '$file_dest_path'!");
            $this->deleteObjOrVersion();
            throw new Exception\Forbidden('Virus found!');
        }
    }

References deleteObjOrVersion(), ilLoggerFactory\getLogger(), and ilUtil\virusHandling().

Referenced by handleFileUpload().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createHistoryAndNotificationForObjUpdate()

ilObjFileDAV::createHistoryAndNotificationForObjUpdate ( $a_action )

protected

Create history entry and a news notification for file object update.

Parameters

$a_action

Definition at line 303 of file class.ilObjFileDAV.php.

    {
        // Add history entry and notification for new file version (stolen from ilObjFile->addFileVersion)
        switch ($a_action) {
            case "new_version":
            case "replace":
                ilHistory::_createEntry($this->obj->getId(), $a_action, $this->obj->getTitle() . "," . $this->obj->getVersion() . "," . $this->obj->getMaxVersion());
                break;
        }
 
        $this->obj->addNewsNotification("file_updated");
    }

References ilHistory\_createEntry().

Referenced by handleFileUpload().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteObjOrVersion()

ilObjFileDAV::deleteObjOrVersion ( )

protected

Delete an object if there is no other version in it otherwise delete version.

Definition at line 319 of file class.ilObjFileDAV.php.

    {
        if ($this->obj->getVersion() > 1) {
            $version_dir = $this->obj->getDirectory($this->obj->getVersion());
            ilUtil::delDir($version_dir);
        } else {
            $this->obj->deleteVersions();
            $this->obj->delete();
        }
    }

References ilUtil\delDir().

Referenced by checkForVirus(), and handleFileUpload().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get()

ilObjFileDAV::get ( )

Returns the data.

This method may either return a string or a readable stream resource

Returns: mixed

Exceptions

Forbidden

Definition at line 97 of file class.ilObjFileDAV.php.

    {
        if ($this->repo_helper->checkAccess("read", $this->obj->getRefId())) {
            $file = $this->getPathToFile();
 
            if (file_exists($file)) {
                return fopen($file, 'r');
            } else {
                throw new Exception\NotFound("File not found");
            }
        }
 
        throw new Exception\Forbidden("Permission denied. No read access for this file");
    }

References getPathToFile().

Here is the call graph for this function:

◆ getContentType()

ilObjFileDAV::getContentType ( )

Returns the mime-type for a file.

If null is returned, we'll assume application/octet-stream

Returns: string|null

Definition at line 129 of file class.ilObjFileDAV.php.

    {
        return  $this->obj->guessFileType();
    }

◆ getETag()

ilObjFileDAV::getETag ( )

Returns the ETag for a file.

An ETag is a unique identifier representing the current version of the file. If the file changes, the ETag MUST change.

Return null if the ETag can not effectively be determined.

The ETag must be surrounded by double-quotes, so something like this would make a valid ETag:

return '"someetag"';

Returns: string|null

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

    {
        if (file_exists($path = $this->getPathToFile())) {
            return '"' . sha1(
                fileinode($path) .
                filesize($path) .
                filemtime($path)
                ) . '"';
        }
        
        return null;
    }

References getPathToFile().

Referenced by put().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getName()

ilObjFileDAV::getName ( )

Returns title of file object.

If it has a forbidden file extension -> ".sec" will be added

Returns: string

Reimplemented from ilObjectDAV.

Definition at line 117 of file class.ilObjFileDAV.php.

    {
        return ilFileUtils::getValidFilename($this->obj->getTitle());
    }

References ilFileUtils\getValidFilename().

Referenced by handleFileUpload().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPathToDirectory()

ilObjFileDAV::getPathToDirectory ( )

protected

Definition at line 249 of file class.ilObjFileDAV.php.

    {
        return $this->obj->getDirectory($this->obj->getVersion());
    }

Referenced by getPathToFile(), and handleFileUpload().

Here is the caller graph for this function:

◆ getPathToFile()

ilObjFileDAV::getPathToFile ( )

protected

This method is called in 2 use cases:

Use case 1: Get the path to an already existing file to download it -> read operation Use case 2: Get the path to save a new file into or overwrite an existing one -> write operation

Exceptions

ilFileUtilsException

Returns: string

Definition at line 263 of file class.ilObjFileDAV.php.

    {
        // ilObjFile delivers the filename like it was on the upload. But if the file-extension is forbidden, the file
        // will be safed as .sec-file. In this case ->getFileName returns the wrong file name
        $path = $this->getPathToDirectory() . "/" . $this->obj->getFileName();
 
        // For the case of forbidden file-extensions, ::getValidFilename($path) returns the path with the .sec extension
        return ilFileUtils::getValidFilename($path);
    }

References getPathToDirectory(), and ilFileUtils\getValidFilename().

Referenced by get(), getETag(), getSize(), and handleFileUpload().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSize()

ilObjFileDAV::getSize ( )

Returns the size of the node, in bytes.

Returns: int

Definition at line 166 of file class.ilObjFileDAV.php.

    {
        if (file_exists($this->getPathToFile())) {
            return $this->obj->getFileSize();
        }
        return 0;
    }

References getPathToFile().

Here is the call graph for this function:

◆ handleFileUpload()

ilObjFileDAV::handleFileUpload	(	$a_data,
		$a_file_action
	)

Handle uploaded file.

Either it is a new file upload to a directory or it is an upload to replace an existing file.

Given data can be a resource or data (given from the sabreDAV library)

Parameters

string | resource $a_data

Exceptions

Forbidden

Definition at line 196 of file class.ilObjFileDAV.php.

    {
        // Set name for uploaded file because due to the versioning, the title can change for different versions. This setter-call here
        // ensures that the uploaded file is saved with the title of the object. This obj->setFileName() has to be called
        // before $this->getPathToFile(). Otherwise, the file could be saved under the wrong filename.
        if ($a_file_action === 'replace') {
            $this->obj->deleteVersions();
            $this->obj->clearDataDirectory();
        }
        $this->obj->setFileName($this->getName());
        $file_dest_path = $this->getPathToFile();
 
        // If dir does not exist yet -> create it
        if (!file_exists($file_dest_path)) {
            ilUtil::makeDirParents($this->getPathToDirectory());
        }
        
        $written_length = $this->uploadFile($a_data, $file_dest_path);
              
        if ($written_length > ilUtil::getUploadSizeLimitBytes()) {
            $this->deleteObjOrVersion();
            throw new Exception\Forbidden('File is too big');
        }
        
        // Security checks
        $this->checkForVirus($file_dest_path);
 
        // Set last meta data
        $this->obj->setFileType(ilMimeTypeUtil::lookupMimeType($file_dest_path));
        $this->obj->setFileSize($written_length);
        if ($this->obj->update()) {
            $this->createHistoryAndNotificationForObjUpdate($a_file_action);
            ilPreview::createPreview($this->obj, true);
        }
    }

References checkForVirus(), createHistoryAndNotificationForObjUpdate(), ilPreview\createPreview(), deleteObjOrVersion(), getName(), getPathToDirectory(), getPathToFile(), ilUtil\getUploadSizeLimitBytes(), ilMimeTypeUtil\lookupMimeType(), ilUtil\makeDirParents(), and uploadFile().

Referenced by put().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ put()

ilObjFileDAV::put ( $data )

Replaces the contents of the file.

The data argument is a readable stream resource.

After a successful put operation, you may choose to return an ETag. The etag must always be surrounded by double-quotes. These quotes must appear in the actual string you're returning.

Clients may use the ETag from a PUT request to later on make sure that when they update the file, the contents haven't changed in the mean time.

If you don't plan to store the file byte-by-byte, and you return a different object on a subsequent GET you are strongly recommended to not return an ETag, and just return null.

Parameters

resource | string $data

Returns: string|null

Exceptions

Forbidden

Definition at line 72 of file class.ilObjFileDAV.php.

    {
        if ($this->repo_helper->checkAccess('write', $this->getRefId())) {
            $this->setObjValuesForNewFileVersion();
            if ($this->versioning_enabled === true) {
                // Stolen from ilObjFile->addFileVersion
                $this->handleFileUpload($data, 'new_version');
            } else {
                $this->handleFileUpload($data, 'replace');
            }
 
 
            return $this->getETag();
        }
        throw new Exception\Forbidden("Permission denied. No write access for this file");
    }

References $data, getETag(), handleFileUpload(), and setObjValuesForNewFileVersion().

Here is the call graph for this function:

◆ setName()

ilObjFileDAV::setName ( $a_name )

Parameters

string $a_name

Exceptions

Forbidden

Reimplemented from ilObjectDAV.

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

    {
        if ($this->dav_helper->isValidFileNameWithValidFileExtension($a_name)) {
            parent::setName($a_name);
        } else {
            throw new Exception\Forbidden("Invalid file extension");
        }
    }

◆ setObjValuesForNewFileVersion()

ilObjFileDAV::setObjValuesForNewFileVersion ( )

protected

Set object values for a new file version.

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

    {
        // This is necessary for windows explorer. Because windows explorer makes always 2 PUT requests. One with a 0 Byte
        // file to test, if the user has write permissions and the second one to upload the original file.
        if ($this->obj->getFileSize() > 0) {
            // Stolen from ilObjFile->addFileVersion
            $this->obj->setVersion($this->obj->getMaxVersion() + 1);
            $this->obj->setMaxVersion($this->obj->getMaxVersion() + 1);
        }
    }

Referenced by put().

Here is the caller graph for this function:

◆ uploadFile()

ilObjFileDAV::uploadFile	(		$a_data,
		string	$file_dest_path
	)

protected

Write given data (as string) to the given file.

Parameters

string \| resource	$a_data
string	$file_dest_path

Exceptions

Exception

Forbidden

Returns: number $written_length

Definition at line 240 of file class.ilObjFileDAV.php.

    {
        $written_length = file_put_contents($file_dest_path, $a_data);
        if ($written_length === false && strlen($a_data) > 0) {
            throw new Exception\Forbidden('Forbidden to write file');
        }
        return $written_length;
    }

Referenced by handleFileUpload().

Here is the caller graph for this function:

Field Documentation

◆ $obj

ilObjFileDAV::$obj

protected

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

◆ $versioning_enabled

ilObjFileDAV::$versioning_enabled

protected

Definition at line 32 of file class.ilObjFileDAV.php.

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

Services/WebDAV/classes/dav/class.ilObjFileDAV.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ checkForVirus()

◆ createHistoryAndNotificationForObjUpdate()

◆ deleteObjOrVersion()

◆ get()

◆ getContentType()

◆ getETag()

◆ getName()

◆ getPathToDirectory()

◆ getPathToFile()

◆ getSize()

◆ handleFileUpload()

◆ put()

◆ setName()

◆ setObjValuesForNewFileVersion()

◆ uploadFile()

Field Documentation

◆ $obj

◆ $versioning_enabled