Inheritance diagram for ilFileXMLParser:

Collaboration diagram for ilFileXMLParser:

Public Member Functions
	__construct ($file, $a_xml_data, $obj_id=-1, $mode=0)
	Constructor. More...

	setImportDirectory ($a_val)
	Set import directory. More...

	getImportDirectory ()
	Get import directory. More...

	setHandlers ($a_xml_parser)
	set event handlers More...

	handlerBeginTag ($a_xml_parser, $a_name, $a_attribs)
	handler for begin of element More...

	handlerEndTag ($a_xml_parser, $a_name)
	handler for end of element More...

	handlerCharacterData ($a_xml_parser, $a_data)
	handler for character data More...

	setFileContents ()
	update file according to filename and version, does not update history has to be called after (!) file save for new objects, since file storage will be initialised with obj id. More...

	updateFileContents ()
	update file according to filename and version and create history entry has to be called after (!) file save for new objects, since file storage will be initialised with obj id. More...

	start ()
	starts parsing an changes object by side effect. More...

Public Member Functions inherited from ilSaxParser
	__construct ($a_xml_file='', $throwException=false)
	Constructor setup ILIAS global object public. More...

	setXMLContent ($a_xml_content)

	getXMLContent ()

	getInputType ()

	startParsing ()
	stores xml data in array More...

	createParser ()
	create parser More...

	setOptions ($a_xml_parser)
	set parser options More...

	setHandlers ($a_xml_parser)
	set event handler should be overwritten by inherited class private More...

	openXMLFile ()
	open xml file More...

	parse ($a_xml_parser, $a_fp=null)
	parse xml file More...

	freeParser ($a_xml_parser)
	free xml parser handle More...

	setThrowException ($throwException)
	set error handling More...

Public Member Functions inherited from PEAR
	__construct ($error_class=null)
	Constructor. More...

	_PEAR ()
	Destructor (the emulated type of...). More...

	registerShutdownFunc ($func, $args=array())
	Use this function to register a shutdown method for static classes. More...

	isError ($data, $code=null)
	Tell whether a value is a PEAR error. More...

	expectError ($code=' *')
	This method is used to tell which errors you expect to get. More...

	popExpect ()
	This method pops one element off the expected error codes stack. More...

	_checkDelExpect ($error_code)
	This method checks unsets an error code if available. More...

	delExpect ($error_code)
	This method deletes all occurences of the specified element from the expected error codes stack. More...

&	raiseError ($message=null, $code=null, $mode=null, $options=null, $userinfo=null, $error_class=null, $skipmsg=false)
	This method is a wrapper that returns an instance of the configured error class with this object's default error handling applied. More...

&	throwError ($message=null, $code=null, $userinfo=null)
	Simpler form of raiseError with fewer options. More...

	staticPushErrorHandling ($mode, $options=null)

	staticPopErrorHandling ()

	pushErrorHandling ($mode, $options=null)
	Push a new error handler on top of the error handler options stack. More...

	popErrorHandling ()
	Pop the last error handler used. More...

	loadExtension ($ext)
	OS independant PHP extension load. More...

Static Public Member Functions
static	normalizeRelativePath ($path)
	Normalize relative directories in a path. More...

Static Public Member Functions inherited from PEAR
static &	getStaticProperty ($class, $var)
	If you have a class that's mostly/entirely static, and you need static properties, you can use this method to simulate them. More...

static	setErrorHandling ($mode=null, $options=null)
	Sets how errors generated by this object should be handled. More...

Data Fields
	$file

	$obj_id

	$result

	$mode

	$tmpFilename

Data Fields inherited from ilSaxParser
	$input_type = null

	$xml_content = ''

	$ilias

	$lng

	$xml_file

	$throwException = false

Data Fields inherited from PEAR
	$_debug = false

	$_default_error_mode = null

	$_default_error_options = null

	$_default_error_handler = ''

	$_error_class = 'PEAR_Error'

	$_expected_errors = array()

Static Public Attributes
static	$CONTENT_NOT_COMPRESSED = 0

static	$CONTENT_GZ_COMPRESSED = 1

static	$CONTENT_ZLIB_COMPRESSED = 2

static	$CONTENT_COPY = 4

static	$CONTENT_REST = 5

Protected Attributes
	$version = null

	$action = null

	$max_version = null

	$date = null

	$usr_id = null

	$versions = []

Additional Inherited Members
Protected Member Functions inherited from ilSaxParser
	handleError ($message, $code)
	use given error handler to handle error message or internal ilias error message handle More...

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilFileXMLParser::__construct	(	$file,
		$a_xml_data,
		$obj_id = `-1`,
		$mode = `0`
	)

Constructor.

Parameters

ilObjFile	$file	existing file object
string	$a_xml_file	xml data
int	$obj_id	obj id of exercise which is to be updated

public

Definition at line 111 of file class.ilFileXMLParser.php.

References $file, $mode, $obj_id, ILIAS\GlobalScreen\Provider\__construct(), and ilSaxParser\setXMLContent().

     {
         parent::__construct();
         $this->file = $file;
         $this->setXMLContent($a_xml_data);
         $this->obj_id = $obj_id;
         $this->result = false;
         $this->mode = $mode;
     }

Here is the call graph for this function:

Member Function Documentation

◆ getImportDirectory()

ilFileXMLParser::getImportDirectory ( )

Get import directory.

Returns: string import directory

Definition at line 138 of file class.ilFileXMLParser.php.

Referenced by handlerEndTag().

     {
         return $this->importDirectory;
     }

Here is the caller graph for this function:

◆ handlerBeginTag()

ilFileXMLParser::handlerBeginTag	(	$a_xml_parser,
		$a_name,
		$a_attribs
	)

handler for begin of element

Parameters

resource	$a_xml_parser	xml parser
string	$a_name	element name
array	$a_attribs	element attributes array

Exceptions

ilFileException when obj id != - 1 and if it it does not match the id in the xml or deflation mode is not supported

Definition at line 169 of file class.ilFileXMLParser.php.

References $CONTENT_COPY, $CONTENT_GZ_COMPRESSED, $CONTENT_NOT_COMPRESSED, $CONTENT_REST, $CONTENT_ZLIB_COMPRESSED, $date, $DIC, ilFileException\$ID_DEFLATE_METHOD_MISMATCH, ilFileException\$ID_MISMATCH, $ilErr, $usr_id, ilUtil\__extractId(), IL_INST_ID, and ilUtil\ilTempnam().

     {
         global $DIC;
         $ilErr = $DIC['ilErr'];
 
         global $DIC;
         $ilLog = $DIC['ilLog'];
 
         switch ($a_name) {
             case 'File':
                 if (isset($a_attribs["obj_id"])) {
                     $read_obj_id = ilUtil::__extractId($a_attribs["obj_id"], IL_INST_ID);
                     if ($this->obj_id != -1 && (int) $read_obj_id != -1 && (int) $this->obj_id != (int) $read_obj_id) {
                         throw new ilFileException(
                             "Object IDs (xml $read_obj_id and argument " . $this->obj_id . ") do not match!",
                             ilFileException::$ID_MISMATCH
                         );
                     }
                 }
                 if (isset($a_attribs["type"])) {
                     $this->file->setFileType($a_attribs["type"]);
                 }
                 $this->file->setVersion($a_attribs["version"]); // Selected version
                 $this->file->setMaxVersion($a_attribs["max_version"]);
                 break;
             case 'Content': // Old import files
             case 'Version':
                 if ($a_name === "Version" && !isset($a_attribs["mode"])) {
                     // Old import files
                     $this->version = null;
                     if ($this->date === null) {
                         // Version tag comes after Content tag. Take only first (= Should be latest)
                         $this->date = $a_attribs["date"];
                         $this->usr_id = $a_attribs["usr_id"];
                         $this->versions[0]["date"] = $this->date;
                         $this->versions[0]["usr_id"] = $this->usr_id;
                     }
                     break;
                 }
 
                 $this->mode = ilFileXMLParser::$CONTENT_NOT_COMPRESSED;
                 $this->isReadingFile = true;
                 $this->tmpFilename = ilUtil::ilTempnam();
                 #echo $a_attribs["mode"];
                 if (isset($a_attribs["mode"])) {
                     if ($a_attribs["mode"] == "GZIP") {
                         if (!function_exists("gzread")) {
                             throw new ilFileException("Deflating with gzip is not supported", ilFileException::$ID_DEFLATE_METHOD_MISMATCH);
                         }
 
                         $this->mode = ilFileXMLParser::$CONTENT_GZ_COMPRESSED;
                     } elseif ($a_attribs["mode"] == "ZLIB") {
                         if (!function_exists("gzuncompress")) {
                             throw new ilFileException("Deflating with zlib (compress/uncompress) is not supported", ilFileException::$ID_DEFLATE_METHOD_MISMATCH);
                         }
 
                         $this->mode = ilFileXMLParser::$CONTENT_ZLIB_COMPRESSED;
                     } elseif ($a_attribs["mode"] == "COPY") {
                         $this->mode = ilFileXMLParser::$CONTENT_COPY;
                     } // begin-patch fm
                     elseif ($a_attribs['mode'] == 'REST') {
                         $this->mode = ilFileXMLParser::$CONTENT_REST;
                     }
                     // end-patch fm
                 }
 
                 if ($a_name === "Version") {
                     $this->version = $a_attribs["version"];
                     $this->max_version = $a_attribs["max_version"];
                     $this->date = $a_attribs["date"];
                     $this->usr_id = $a_attribs["usr_id"];
                     $this->action = $a_attribs["action"];
                 } else {
                     // Old import files
                     //$this->version = $this->file->getVersion();
                     $this->version = 1;
                     $this->file->setVersion($this->version);
                 }
         }
     }

Here is the call graph for this function:

◆ handlerCharacterData()

ilFileXMLParser::handlerCharacterData	(	$a_xml_parser,
		$a_data
	)

handler for character data

Parameters

resource	$a_xml_parser	xml parser
string	$a_data	character data

Definition at line 371 of file class.ilFileXMLParser.php.

References $CONTENT_COPY, and $CONTENT_REST.

     {
         if ($a_data != "\n") {
             // begin-patch fm
             if ($this->isReadingFile && $this->mode != ilFileXMLParser::$CONTENT_COPY
                 && $this->mode != ilFileXMLParser::$CONTENT_REST
             ) { // begin-patch fm
                 $handle = fopen($this->tmpFilename, "a");
                 fwrite($handle, $a_data);
                 fclose($handle);
             } else {
                 $this->cdata .= $a_data;
             }
         }
     }

◆ handlerEndTag()

ilFileXMLParser::handlerEndTag	(	$a_xml_parser,
		$a_name
	)

handler for end of element

Parameters

resource	$a_xml_parser	xml parser
string	$a_name	element name

Definition at line 257 of file class.ilFileXMLParser.php.

References $action, $CONTENT_COPY, $CONTENT_GZ_COMPRESSED, $CONTENT_REST, $CONTENT_ZLIB_COMPRESSED, $date, ilFileException\$DECOMPRESSION_FAILED, $DIC, $GLOBALS, $max_version, $tmpFilename, $usr_id, $version, ilFileUtils\_lookupMimeType(), ilFileUtils\fastBase64Decode(), ilFileUtils\fastGunzip(), getImportDirectory(), and ilUtil\ilTempnam().

     {
         $this->cdata = trim($this->cdata);
 
         $GLOBALS['DIC']['ilLog']->write(__METHOD__ . ': ' . $this->cdata);
 
         switch ($a_name) {
             case 'File':
                 $this->result = true;
                 break;
             case 'Filename':
                 if (strlen($this->cdata) == 0) {
                     throw new ilFileException("Filename ist missing!");
                 }
 
                 $this->file->setFilename($this->cdata);
                 $this->file->setTitle($this->cdata);
 
                 break;
             case 'Title':
                 $this->file->setTitle(trim($this->cdata));
                 break;
             case 'Description':
                 $this->file->setDescription(trim($this->cdata));
                 break;
             case 'Rating':
                 $this->file->setRating((bool) $this->cdata);
                 break;
             case 'Content': // Old import files
             case 'Version':
                 if ($a_name === "Version" && $this->version === null) {
                     // Old import files
                     break;
                 }
 
                 $GLOBALS['DIC']['ilLog']->write($this->mode);
                 $this->isReadingFile = false;
                 $baseDecodedFilename = ilUtil::ilTempnam();
                 if ($this->mode == ilFileXMLParser::$CONTENT_COPY) {
                     $this->tmpFilename = $this->getImportDirectory() . "/" . self::normalizeRelativePath($this->cdata);
                 } // begin-patch fm
                 elseif ($this->mode == ilFileXMLParser::$CONTENT_REST) {
                     include_once './Services/WebServices/Rest/classes/class.ilRestFileStorage.php';
                     $storage = new ilRestFileStorage();
                     $this->tmpFilename = $storage->getStoredFilePath(self::normalizeRelativePath($this->cdata));
                     if (!ilFileUtils::fastBase64Decode($this->tmpFilename, $baseDecodedFilename)) {
                         throw new ilFileException("Base64-Decoding failed", ilFileException::$DECOMPRESSION_FAILED);
                     }
                     $this->tmpFilename = $baseDecodedFilename;
                 } // end-patch fm
                 else {
                     if (!ilFileUtils::fastBase64Decode($this->tmpFilename, $baseDecodedFilename)) {
                         throw new ilFileException("Base64-Decoding failed", ilFileException::$DECOMPRESSION_FAILED);
                     }
                     if ($this->mode == ilFileXMLParser::$CONTENT_GZ_COMPRESSED) {
                         if (!ilFileUtils::fastGunzip($baseDecodedFilename, $this->tmpFilename)) {
                             throw new ilFileException("Deflating with fastzunzip failed", ilFileException::$DECOMPRESSION_FAILED);
                         }
                         unlink($baseDecodedFilename);
                     } elseif ($this->mode == ilFileXMLParser::$CONTENT_ZLIB_COMPRESSED) {
                         if (!ilFileUtils::fastGunzip($baseDecodedFilename, $this->tmpFilename)) {
                             throw new ilFileException("Deflating with fastDecompress failed", ilFileException::$DECOMPRESSION_FAILED);
                         }
                         unlink($baseDecodedFilename);
                     } else {
                         $this->tmpFilename = $baseDecodedFilename;
                     }
                 }
 
                 //$this->content = $content;
                 // see #17211
 
                 if ($this->version == $this->file->getVersion()) {
                     if (is_file($this->tmpFilename)) {
                         $this->file->setFileSize(filesize($this->tmpFilename)); // strlen($this->content));
                     }
 
                     // if no file type is given => lookup mime type
                     if (!$this->file->getFileType()) {
                         global $DIC;
                         $ilLog = $DIC['ilLog'];
 
                         #$ilLog->write(__METHOD__.': Trying to detect mime type...');
                         include_once('./Services/Utilities/classes/class.ilFileUtils.php');
                         $this->file->setFileType(ilFileUtils::_lookupMimeType($this->tmpFilename));
                     }
                 }
 
                 $this->versions[] = [
                     "version" => $this->version,
                     "max_version" => $this->max_version,
                     "tmpFilename" => $this->tmpFilename,
                     "date" => $this->date,
                     "usr_id" => $this->usr_id,
                     "action" => $this->action,
                 ];
                 $this->version = null;
                 $this->date = null;
                 $this->usr_id = null;
                 break;
         }
 
         $this->cdata = '';
 
         return;
     }

Here is the call graph for this function:

◆ normalizeRelativePath()

static ilFileXMLParser::normalizeRelativePath ( $path )

static

Normalize relative directories in a path.

Source: https://github.com/thephpleague/flysystem/blob/master/src/Util.php#L96 Workaround until we have

Parameters

string $path

Returns: string

Exceptions

LogicException

Definition at line 474 of file class.ilFileXMLParser.php.

     {
         $path = str_replace('\\', '/', $path);
 
         while (preg_match('#\p{C}+|^\./#u', $path)) {
             $path = preg_replace('#\p{C}+|^\./#u', '', $path);
         }
 
         $parts = [];
         foreach (explode('/', $path) as $part) {
             switch ($part) {
                 case '':
                 case '.':
                     break;
                 case '..':
                     array_pop($parts);
                     break;
                 default:
                     $parts[] = $part;
                     break;
             }
         }
 
         return implode('/', $parts);
     }

◆ setFileContents()

ilFileXMLParser::setFileContents ( )

update file according to filename and version, does not update history has to be called after (!) file save for new objects, since file storage will be initialised with obj id.

Definition at line 393 of file class.ilFileXMLParser.php.

References $version, ilHistory\_removeEntriesForObject(), and ilLoggerFactory\getLogger().

Referenced by updateFileContents().

     {
         // Delete exists version 1 history
         ilHistory::_removeEntriesForObject($this->file->getId());
 
         foreach ($this->versions as $version) {
             if (!file_exists($version["tmpFilename"])) {
                 if (!isset($version["tmpFilename"])) {
                     continue;
                 }
                 // try to get first file of directory
                 $files = scandir(dirname($version["tmpFilename"]));
                 $version["tmpFilename"] = rtrim(dirname($version["tmpFilename"]),
                         "/") . "/" . $files[2];// because [0] = "." [1] = ".."
                 if (!file_exists($version["tmpFilename"])) {
                     ilLoggerFactory::getLogger('file')->error(__METHOD__ . ' "' . ($version["tmpFilename"]) . '" file not found.');
 
                     continue;
                 }
             }
 
             if (filesize($version["tmpFilename"]) == 0) {
                 continue;
             }
 
             // imported file version
             $import_file_version_path = $version["tmpFilename"];
 
             $stream = Streams::ofResource(fopen($import_file_version_path, 'rb'));
             $this->file->appendStream($stream, $this->file->getTitle());
         }
     }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setHandlers()

ilFileXMLParser::setHandlers ( $a_xml_parser )

set event handlers

Parameters

resource reference to the xml parser

private

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

     {
         xml_set_object($a_xml_parser, $this);
         xml_set_element_handler($a_xml_parser, 'handlerBeginTag', 'handlerEndTag');
         xml_set_character_data_handler($a_xml_parser, 'handlerCharacterData');
     }

◆ setImportDirectory()

ilFileXMLParser::setImportDirectory ( $a_val )

Set import directory.

Parameters

string import directory

Definition at line 127 of file class.ilFileXMLParser.php.

     {
         $this->importDirectory = $a_val;
     }

◆ start()

ilFileXMLParser::start ( )

starts parsing an changes object by side effect.

Returns: boolean true, if no errors happend.

Exceptions

ilFileException when obj id != - 1 and if it it does not match the id in the xml

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

References ilSaxParser\startParsing().

     {
         $this->startParsing();
 
         return $this->result > 0;
     }

Here is the call graph for this function:

◆ updateFileContents()

ilFileXMLParser::updateFileContents ( )

update file according to filename and version and create history entry has to be called after (!) file save for new objects, since file storage will be initialised with obj id.

Definition at line 432 of file class.ilFileXMLParser.php.

References ilHistory\_createEntry(), and setFileContents().

     {
         if ($this->setFileContents()) {
 
                 if ($this->file->getAction() != "" and $this->file->getAction() != null) {
                     ilHistory::_createEntry($this->file->getId(), $this->file->getAction(), $this->file->getFilename() . "," . $this->file->getVersion() . "," . $this->file->getMaxVersion());
                 } else {
                     ilHistory::_createEntry($this->file->getId(), "replace", $this->file->getFilename() . "," . $this->file->getVersion() . "," . $this->file->getMaxVersion());
                 }
 
             $this->file->notifyUpdate($this->file->getId(), $this->file->getDescription());
         }
     }

Here is the call graph for this function:

Field Documentation

◆ $action

ilFileXMLParser::$action = null

protected

Definition at line 83 of file class.ilFileXMLParser.php.

Referenced by handlerEndTag().

◆ $CONTENT_COPY

ilFileXMLParser::$CONTENT_COPY = 4

static

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

Referenced by handlerBeginTag(), handlerCharacterData(), and handlerEndTag().

◆ $CONTENT_GZ_COMPRESSED

ilFileXMLParser::$CONTENT_GZ_COMPRESSED = 1

static

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

Referenced by handlerBeginTag(), and handlerEndTag().

◆ $CONTENT_NOT_COMPRESSED

ilFileXMLParser::$CONTENT_NOT_COMPRESSED = 0

static

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

Referenced by handlerBeginTag().

◆ $CONTENT_REST

ilFileXMLParser::$CONTENT_REST = 5

static

Definition at line 29 of file class.ilFileXMLParser.php.

Referenced by handlerBeginTag(), handlerCharacterData(), and handlerEndTag().

◆ $CONTENT_ZLIB_COMPRESSED

ilFileXMLParser::$CONTENT_ZLIB_COMPRESSED = 2

static

Definition at line 26 of file class.ilFileXMLParser.php.

Referenced by handlerBeginTag(), and handlerEndTag().

◆ $date

ilFileXMLParser::$date = null

protected

Definition at line 91 of file class.ilFileXMLParser.php.

Referenced by handlerBeginTag(), and handlerEndTag().

◆ $file

ilFileXMLParser::$file

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

Referenced by __construct().

◆ $max_version

ilFileXMLParser::$max_version = null

protected

Definition at line 87 of file class.ilFileXMLParser.php.

Referenced by handlerEndTag().

◆ $mode

ilFileXMLParser::$mode

Definition at line 55 of file class.ilFileXMLParser.php.

Referenced by __construct().

◆ $obj_id

ilFileXMLParser::$obj_id

Definition at line 43 of file class.ilFileXMLParser.php.

Referenced by __construct().

◆ $result

ilFileXMLParser::$result

Definition at line 49 of file class.ilFileXMLParser.php.

◆ $tmpFilename

ilFileXMLParser::$tmpFilename

Definition at line 68 of file class.ilFileXMLParser.php.

Referenced by handlerEndTag().

◆ $usr_id

ilFileXMLParser::$usr_id = null

protected

Definition at line 95 of file class.ilFileXMLParser.php.

Referenced by handlerBeginTag(), and handlerEndTag().

◆ $version

ilFileXMLParser::$version = null

protected

Definition at line 79 of file class.ilFileXMLParser.php.

Referenced by handlerEndTag(), and setFileContents().

◆ $versions

ilFileXMLParser::$versions = []

protected

Definition at line 99 of file class.ilFileXMLParser.php.

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

Modules/File/classes/class.ilFileXMLParser.php

Public Member Functions

Static Public Member Functions

Data Fields

Static Public Attributes

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ getImportDirectory()

◆ handlerBeginTag()

◆ handlerCharacterData()

◆ handlerEndTag()

◆ normalizeRelativePath()

◆ setFileContents()

◆ setHandlers()

◆ setImportDirectory()

◆ start()

◆ updateFileContents()

Field Documentation

◆ $action

◆ $CONTENT_COPY

◆ $CONTENT_GZ_COMPRESSED

◆ $CONTENT_NOT_COMPRESSED

◆ $CONTENT_REST

◆ $CONTENT_ZLIB_COMPRESSED

◆ $date

◆ $file

◆ $max_version

◆ $mode

◆ $obj_id

◆ $result

◆ $tmpFilename

◆ $usr_id

◆ $version

◆ $versions