This base-class simplifies the creation of (consecutive) database updates. More...

Inheritance diagram for ilDatabaseUpdateSteps:

Collaboration diagram for ilDatabaseUpdateSteps:

Public Member Functions
	__construct (Objective $base)

	getAdditionalPreconditionsForStep (int $num)
	Get preconditions for steps. More...

	getHash ()
	The hash for the objective is calculated over the classname and the steps that are contained. More...

	getLabel ()
	Get a label that describes this objective. More...

	isNotable ()
	@inheritdocs More...

	getPreconditions (Environment $environment)
	@inheritdocs More...

	achieve (Environment $environment)
	@inheritdocs More...

	getStep (int $num, int $finished=0)
	Get a database update step. More...

	getLatestStepNum ()
	Get the number of latest database step in this class. More...

	getHash ()
	Get a hash for this objective. More...

	getLabel ()
	Get a label that describes this objective. More...

	isNotable ()
	Get to know if this is an interesting objective for a human. More...

	getPreconditions (Environment $environment)
	Objectives might depend on other objectives. More...

	achieve (Environment $environment)
	Objectives can be achieved. More...

Data Fields
const	STEP_METHOD_PREFIX = "step_"

Protected Member Functions
	getSteps ()
	Get the numbers of the steps in this class. More...

Protected Attributes
	$steps = null

	$base

Detailed Description

This base-class simplifies the creation of (consecutive) database updates.

Implement update steps on one or more tables by creating methods that follow this schema:

public function step_1(\ilDBInterface $db) { ... }

The class will figure out which of them haven't been performed yet and need to be executed.

If the class takes care of only one table or a set of related tables it will be easier to maintain.

If for some reason you rely on other objectives, e.g. steps from other db-update classes, implement getAdditionalPreconditionsForStep.

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

Constructor & Destructor Documentation

◆ __construct()

ilDatabaseUpdateSteps::__construct ( Objective $base )

Parameters

\ilObjective $base for the update steps, i.e. the objective that should have been reached before the steps of this class can even begin. Most probably this should be \ilDatabasePopulatedObjective.

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

      {
        $this->base = $base;
    }

References $base, and base().

Here is the call graph for this function:

Member Function Documentation

◆ achieve()

ilDatabaseUpdateSteps::achieve ( Environment $environment )

final

@inheritdocs

Implements ILIAS\Setup\Objective.

Definition at line 110 of file class.ilDatabaseUpdateSteps.php.

                                                            : Environment
    {
        return $environment;
    }

◆ getAdditionalPreconditionsForStep()

ilDatabaseUpdateSteps::getAdditionalPreconditionsForStep ( int $num )

Get preconditions for steps.

The previous step will automatically be a precondition of every step but will not be returned from this method.

Returns: Objective[]

Reimplemented in Test_ilDatabaseUpdateSteps.

Definition at line 61 of file class.ilDatabaseUpdateSteps.php.

Referenced by getStep().

Here is the caller graph for this function:

◆ getHash()

ilDatabaseUpdateSteps::getHash ( )

final

The hash for the objective is calculated over the classname and the steps that are contained.

Implements ILIAS\Setup\Objective.

Definition at line 70 of file class.ilDatabaseUpdateSteps.php.

                                    : string
    {
        return hash(
            "sha256",
            get_class($this)
        );
    }

◆ getLabel()

ilDatabaseUpdateSteps::getLabel ( )

final

Get a label that describes this objective.

Implements ILIAS\Setup\Objective.

Definition at line 78 of file class.ilDatabaseUpdateSteps.php.

                                     : string
    {
        return "Database update steps in " . get_class($this);
    }

◆ getLatestStepNum()

ilDatabaseUpdateSteps::getLatestStepNum ( )

final

Get the number of latest database step in this class.

Definition at line 140 of file class.ilDatabaseUpdateSteps.php.

                                             : int
    {
        $this->getSteps();
        return end($this->steps);
    }

References getSteps().

Referenced by getPreconditions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getPreconditions()

ilDatabaseUpdateSteps::getPreconditions ( Environment $environment )

final

@inheritdocs

Implements ILIAS\Setup\Objective.

Definition at line 94 of file class.ilDatabaseUpdateSteps.php.

                                                                     : array
    {
        $log = $environment->getResource(\ilDatabaseUpdateStepExecutionLog::class);
 
        if ($log) {
            $finished = $log->getLastFinishedStep(get_class($this));
        } else {
            $finished = 0;
        }
 
        return [$this->getStep($this->getLatestStepNum(), $finished)];
    }

References $log, getLatestStepNum(), ILIAS\Setup\Environment\getResource(), and getStep().

Here is the call graph for this function:

◆ getStep()

ilDatabaseUpdateSteps::getStep	(	int	$num,
		int	$finished = `0`
	)

final

Get a database update step.

Optionally tell which step is known to have been finished to exclude it from the preconditions of the newer steps.

Exceptions

LogicException if step is unknown

Definition at line 121 of file class.ilDatabaseUpdateSteps.php.

                                                               : ilDatabaseUpdateStep
    {
        $cur = $this->base;
        foreach ($this->getSteps() as $s) {
            if ($s <= $finished) {
                continue;
            } elseif ($s <= $num) {
                $cur = new ilDatabaseUpdateStep($this, $s, $cur, ...$this->getAdditionalPreconditionsForStep($s));
            } else {
                break;
            }
        }
 
        return $cur;
    }

References $base, getAdditionalPreconditionsForStep(), and getSteps().

Referenced by getPreconditions().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSteps()

ilDatabaseUpdateSteps::getSteps ( )

finalprotected

Get the numbers of the steps in this class.

Returns: int[]

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

                                        : array
    {
        if (!is_null($this->steps)) {
            return $this->steps;
        }
 
        $this->steps = [];
 
        foreach (get_class_methods(static::class) as $method) {
            if (stripos($method, self::STEP_METHOD_PREFIX) !== 0) {
                continue;
            }
 
            $number = substr($method, strlen(self::STEP_METHOD_PREFIX));
 
            if (!preg_match("/^[1-9]\d*$/", $number)) {
                throw new \LogicException("Method $method seems to be a step but has an odd looking number");
            }
 
            $this->steps[(int) $number] = (int) $number;
        }
 
        asort($this->steps);
 
        return $this->steps;
    }

References $steps.

Referenced by Test_ilDatabaseUpdateSteps\_getSteps(), getLatestStepNum(), and getStep().

Here is the caller graph for this function:

◆ isNotable()

ilDatabaseUpdateSteps::isNotable ( )

final

@inheritdocs

Implements ILIAS\Setup\Objective.

Definition at line 86 of file class.ilDatabaseUpdateSteps.php.

                                      : bool
    {
        return true;
    }

Field Documentation

◆ $base

ilDatabaseUpdateSteps::$base

protected

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

Referenced by __construct(), and getStep().

◆ $steps

ilDatabaseUpdateSteps::$steps = null

protected

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

Referenced by getSteps().

◆ STEP_METHOD_PREFIX

const ilDatabaseUpdateSteps::STEP_METHOD_PREFIX = "step_"

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

Referenced by ilDatabaseUpdateStep\__construct().

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

Services/Database/classes/Setup/class.ilDatabaseUpdateSteps.php

Public Member Functions

Data Fields

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ achieve()

◆ getAdditionalPreconditionsForStep()

◆ getHash()

◆ getLabel()

◆ getLatestStepNum()

◆ getPreconditions()

◆ getStep()

◆ getSteps()

◆ isNotable()

Field Documentation

◆ $base

◆ $steps

◆ STEP_METHOD_PREFIX