ilDBUpdate Class Reference

Database Update class. More...

Inheritance diagram for ilDBUpdate:

Collaboration diagram for ilDBUpdate:

Public Member Functions
	__construct (protected ilDBInterface $db, protected ?ilIniFile $client_ini=null)
	getCustomUpdatesCurrentVersion ()
	getCustomUpdatesFileVersion ()
	applyCustomUpdates ()

Protected Member Functions
	checkQuery (string $q)
	initGlobalsRequiredForUpdateSteps (?ilCtrlStructureReader &$ilCtrlStructureReader, ?ilDBInterface &$ilDB)
	applyUpdateNr (int $nr, bool $custom_update=false)
	Apply a custom database update or a plugin update. More...
	setCurrentVersion (?int $a_version)

Protected Attributes
string	$updateMsg
Iterator	$ctrl_structure_iterator
string	$error
string	$PATH = "./"
array	$filecontent

Private Member Functions
	execQuery (ilDBInterface $db, string $str)
	setCustomUpdatesCurrentVersion (?int $a_version)
	readCustomUpdatesFileVersion (array $a_file_content)
	readCustomUpdatesInfo (bool $a_force=false)

Private Attributes
int	$custom_updates_current_version = 0
int	$custom_updates_file_version = null
bool	$custom_updates_info_read = null
ilSetting	$custom_updates_setting
array	$custom_updates_content = []

Detailed Description

Database Update class.

Author

Peter Gabriel pgabr.nosp@m.iel@.nosp@m.datab.nosp@m.ay.d.nosp@m.e

Alex Killing alex..nosp@m.kill.nosp@m.ing@g.nosp@m.mx.d.nosp@m.e

Version

$Id$

Definition at line 28 of file class.ilDBUpdate.php.

Constructor & Destructor Documentation

__construct()

ilDBUpdate::__construct	(	protected ilDBInterface	$db,
		protected ?ilIniFile	$client_ini = null
	)

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

    {
        $class_map = require ILIAS_ABSOLUTE_PATH . '/vendor/composer/vendor/composer/autoload_classmap.php';
        $this->ctrl_structure_iterator = new ilCtrlArrayIterator($class_map);
    }

Member Function Documentation

applyCustomUpdates()

ilDBUpdate::applyCustomUpdates

(

)

Definition at line 262 of file class.ilDBUpdate.php.

                                        : bool
    {
        $ilCtrlStructureReader = null;
        $ilDB = null;
        $this->initGlobalsRequiredForUpdateSteps($ilCtrlStructureReader, $ilDB);
        $this->readCustomUpdatesInfo(true);
 
        $file_version = $this->getCustomUpdatesFileVersion();
        $current_version = $this->getCustomUpdatesCurrentVersion();
        $this->filecontent = $this->custom_updates_content;
 
        $this->updateMsg = 'no_changes';
        if ($current_version < $file_version) {
            $msg = [];
            for ($i = ($current_version + 1); $i <= $file_version; $i++) {
                if ($this->applyUpdateNr($i, true) === false) {
                    $msg[] = [
                        'msg' => 'update_error: ' . $this->error,
                        'nr' => $i,
                    ];
                    $this->updateMsg = implode("\n", $msg);
 
                    return false;
                }
 
                $msg[] = [
                    'msg' => 'custom_update_applied',
                    'nr' => $i,
                ];
            }
 
            $this->updateMsg = implode("\n", $msg);
        }
 
        return true;
    }

References $ilDB.

applyUpdateNr()

ilDBUpdate::applyUpdateNr ( int  $nr, bool  $custom_update = false  )

protected

Apply a custom database update or a plugin update.

Parameters

int

$nr

number what patch to apply (Reference: Patch for https://mantis.ilias.de/view.php?id=28550) @access private

Definition at line 123 of file class.ilDBUpdate.php.

                                                                          : bool
    {
        $ilCtrlStructureReader = null;
        $ilDB = null;
        $this->initGlobalsRequiredForUpdateSteps($ilCtrlStructureReader, $ilDB);
 
        reset($this->filecontent);
 
        //init
        $i = 0;
 
        //go through filecontent
        while (!preg_match("/^<\#" . $nr . ">/", (string) $this->filecontent[$i]) && $i < count($this->filecontent)) {
            $i++;
        }
 
        //update not found
        if ($i === count($this->filecontent)) {
            $this->error = 'update_not_found';
 
            return false;
        }
 
        $i++;
 
        //update found, now extract this update to a new array
        $update = [];
        while ($i < count($this->filecontent) && !preg_match("/^<#" . ($nr + 1) . ">/", (string) $this->filecontent[$i])) {
            $update[] = trim((string) $this->filecontent[$i]);
            $i++;
        }
 
        //now you have the update, now process it
        $sql = [];
        $php = [];
        $mode = 'sql';
 
        foreach ($update as $row) {
            if (preg_match("/<\?php/", $row)) {
                if ($sql !== []) {
                    if ($this->execQuery($this->db, implode("\n", $sql)) === false) {
                        return false;
                    }
                    $sql = [];
                }
                $mode = 'php';
            } elseif (preg_match("/\?>/", $row)) {
                if ($php !== []) {
                    $code = implode("\n", $php);
                    if (eval($code) === false) {
                        $this->error = 'Parse error: ' . $code;
 
                        return false;
                    }
                    $php = [];
                }
                $mode = 'sql';
            } else {
                if ($mode === 'sql') {
                    $sql[] = $row;
                }
 
                if ($mode === 'php') {
                    $php[] = $row;
                }
            }
        }
 
        if ($mode === 'sql' && $sql !== [] && $this->execQuery($this->db, implode("\n", $sql)) === false) {
            $this->error = "dump_error: " . $this->error;
 
            return false;
        }
 
        if ($custom_update) {
            $this->setCustomUpdatesCurrentVersion($nr);
        } else {
            $this->setCurrentVersion($nr);
        }
 
        return true;
    }

References $ilDB, and error().

Referenced by ilPluginDBUpdate\applyUpdate().

Here is the call graph for this function:

Here is the caller graph for this function:

checkQuery()

ilDBUpdate::checkQuery ( string  $q )

protected

Reimplemented in ilPluginDBUpdate.

Definition at line 85 of file class.ilDBUpdate.php.

                                            : bool
    {
        return true;
    }

Referenced by execQuery().

Here is the caller graph for this function:

execQuery()

ilDBUpdate::execQuery ( ilDBInterface  $db, string  $str  )

private

@noinspection PhpUndefinedVariableInspection

@noinspection PhpUndefinedVariableInspection

Definition at line 50 of file class.ilDBUpdate.php.

                                                              : bool
    {
        $q = "";
        $sql = explode("\n", trim($str));
        foreach ($sql as $i => $statement) {
            $sql[$i] = trim($statement);
            if ($statement !== "" && $statement[0] !== "#") {
                //take line per line, until last char is ";"
                if (str_ends_with($statement, ";")) {
                    //query is complete
                    $q .= " " . substr($statement, 0, -1);
                    $check = $this->checkQuery($q);
                    if ($check) {
                        $db->query($q);
                    } else {
                        $this->error = (string) $check;
                        return false;
                    }
                    unset($q);
                } else {
                    $q .= " " . $statement;
                }
            }
        }
        if (isset($q) && $q !== "") {
            echo "incomplete_statement: " . $q . "<br>";
 
            return false;
        }
 
        return true;
    }

References $check, $q, checkQuery(), error(), and ilDBInterface\query().

Here is the call graph for this function:

getCustomUpdatesCurrentVersion()

ilDBUpdate::getCustomUpdatesCurrentVersion

(

)

Definition at line 206 of file class.ilDBUpdate.php.

                                                    : ?int
    {
        $this->readCustomUpdatesInfo();
 
        return $this->custom_updates_current_version;
    }

getCustomUpdatesFileVersion()

ilDBUpdate::getCustomUpdatesFileVersion

(

)

Definition at line 224 of file class.ilDBUpdate.php.

                                                 : ?int
    {
        $this->readCustomUpdatesInfo();
 
        return $this->custom_updates_file_version;
    }

initGlobalsRequiredForUpdateSteps()

ilDBUpdate::initGlobalsRequiredForUpdateSteps ( ?ilCtrlStructureReader &  $ilCtrlStructureReader, ?ilDBInterface &  $ilDB  )

protected

Definition at line 90 of file class.ilDBUpdate.php.

     : void {
        global $DIC;
 
        // TODO: There is currently a huge mixup of globals, $DIC and dependencies, esprecially in setup and during DB-Updates. This leads to many problems. The following core tries to provide the needed dependencies for the dbupdate-script. The code hopefully will change in the future.
 
        if (isset($GLOBALS['ilCtrlStructureReader'])) {
            $ilCtrlStructureReader = $GLOBALS['ilCtrlStructureReader'];
        } elseif ($DIC->offsetExists('ilCtrlStructureReader')) {
            $ilCtrlStructureReader = $DIC['ilCtrlStructureReader'];
        } else {
            $ilCtrlStructureReader = new ilCtrlStructureReader(
                $this->ctrl_structure_iterator,
                new ilCtrlStructureCidGenerator()
            );
            $DIC->offsetSet('ilCtrlStructureReader', $ilCtrlStructureReader);
        }
 
        $GLOBALS['ilCtrlStructureReader'] = $ilCtrlStructureReader;
 
        if ($this->client_ini !== null) {
            $ilCtrlStructureReader->setIniFile($this->client_ini);
        }
        $ilDB = $DIC->database();
    }

References $GLOBALS.

Referenced by ilPluginDBUpdate\applyUpdate().

Here is the caller graph for this function:

readCustomUpdatesFileVersion()

ilDBUpdate::readCustomUpdatesFileVersion ( array  $a_file_content )

private

Definition at line 231 of file class.ilDBUpdate.php.

                                                                        : int
    {
        //go through file content and search for last occurrence of <#x>
        reset($a_file_content);
        $regs = [];
        $version = 0;
        foreach ($a_file_content as $row) {
            if (preg_match("/^<#(\\d+)>/", (string) $row, $regs)) {
                $version = $regs[1];
            }
        }
 
        return (int) $version;
    }

References $version.

readCustomUpdatesInfo()

ilDBUpdate::readCustomUpdatesInfo ( bool  $a_force = false )

private

Definition at line 246 of file class.ilDBUpdate.php.

                                                                 : void
    {
        if ($this->custom_updates_info_read && !$a_force) {
            return;
        }
 
        $this->custom_updates_setting = new ilSetting();
        $custom_updates_file = $this->PATH . './components/ILIAS/setup_/sql/dbupdate_custom.php';
        if (is_file($custom_updates_file)) {
            $this->custom_updates_content = @file($custom_updates_file);
            $this->custom_updates_current_version = (int) $this->custom_updates_setting->get('db_version_custom', '0');
            $this->custom_updates_file_version = $this->readCustomUpdatesFileVersion($this->custom_updates_content);
        }
        $this->custom_updates_info_read = true;
    }

References ILIAS\Repository\int().

Here is the call graph for this function:

setCurrentVersion()

ilDBUpdate::setCurrentVersion ( ?int  $a_version )

protected

Reimplemented in ilPluginDBUpdate.

Definition at line 220 of file class.ilDBUpdate.php.

                                                         : void
    {
    }

setCustomUpdatesCurrentVersion()

ilDBUpdate::setCustomUpdatesCurrentVersion ( ?int  $a_version )

private

Definition at line 213 of file class.ilDBUpdate.php.

                                                                    : void
    {
        $this->readCustomUpdatesInfo();
        $this->custom_updates_setting->set('db_version_custom', (string) $a_version);
        $this->custom_updates_current_version = $a_version;
    }

Field Documentation

$ctrl_structure_iterator

Iterator ilDBUpdate::$ctrl_structure_iterator

protected

Definition at line 31 of file class.ilDBUpdate.php.

$custom_updates_content

array ilDBUpdate::$custom_updates_content = []

private

Definition at line 42 of file class.ilDBUpdate.php.

$custom_updates_current_version

int ilDBUpdate::$custom_updates_current_version = 0

private

Definition at line 38 of file class.ilDBUpdate.php.

$custom_updates_file_version

int ilDBUpdate::$custom_updates_file_version = null

private

Definition at line 39 of file class.ilDBUpdate.php.

$custom_updates_info_read

bool ilDBUpdate::$custom_updates_info_read = null

private

Definition at line 40 of file class.ilDBUpdate.php.

$custom_updates_setting

ilSetting ilDBUpdate::$custom_updates_setting

private

Definition at line 41 of file class.ilDBUpdate.php.

$error

string ilDBUpdate::$error

protected

Definition at line 33 of file class.ilDBUpdate.php.

$filecontent

array ilDBUpdate::$filecontent

protected

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

$PATH

string ilDBUpdate::$PATH = "./"

protected

Definition at line 34 of file class.ilDBUpdate.php.

$updateMsg

string ilDBUpdate::$updateMsg

protected

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

---

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

• components/ILIAS/Database/classes/class.ilDBUpdate.php