MigrationObjective.php

Go to the documentation of this file.

<?php
 
namespace ILIAS\Setup\Objective;
 
use ILIAS\Setup;
 
class MigrationObjective implements Setup\Objective
{
    protected $migration;
    protected $steps;
 
    public function __construct(Setup\Migration $migration, int $steps = null)
    {
        $this->migration = $migration;
        $this->steps = $steps ?? $migration->getDefaultAmountOfStepsPerRun();
    }
 
    public function getHash() : string
    {
        return hash("sha256", self::class . '' . get_class($this->migration));
    }
 
    public function getLabel() : string
    {
        return $this->migration->getLabel();
    }
 
    public function isNotable() : bool
    {
        return true;
    }
 
    public function getPreconditions(Setup\Environment $environment) : array
    {
        return $this->migration->getPreconditions($environment);
    }
 
    public function achieve(Setup\Environment $environment) : Setup\Environment
    {
        $io = $environment->getResource(Setup\Environment::RESOURCE_ADMIN_INTERACTION);
        $key = (new \ReflectionClass($this->migration))->getShortName();
        $confirmation = $io->confirmExplicit(
            "Do you really want to run the following migration? Make sure you have a backup\n" .
            "of all your data. You will run this migration on your own risk.\n\n" .
            "Please type '$key' to confirm and start.",
            $key
        );
        if (!$confirmation) {
            $io->error("Migration '$key' aborted.");
            return $environment;
        }
        $io->inform("Preparing Migration: This may take quite a long time (e.g. all files are collected.");
        $this->migration->prepare($environment);
        $io->inform("Preparing Migration: done.");
 
        $steps = $this->steps;
        $remaining = $this->migration->getRemainingAmountOfSteps();
        if ($steps === Setup\Migration::INFINITE || $remaining < $steps) {
            $steps = $remaining;
        }
        $io->inform("Trigger {$steps} step(s) in {$this->getLabel()}");
        $step = 0;
        $io->startProgress($steps);
 
        while ($step < $steps) {
            $io->advanceProgress();
            $this->migration->step($environment);
            $step++;
        }
        $io->stopProgress();
        $remaining = $this->migration->getRemainingAmountOfSteps();
        if ($remaining == 0) {
            $io->inform("Migration '{$key}' has no remaining steps left.");
        }
        else {
            $io->inform("{$remaining} step(s) remaining. Run again to proceed.");
        }
 
        return $environment;
    }
 
    public function isApplicable(Setup\Environment $environment) : bool
    {
        $this->migration->prepare($environment);
 
        return $this->migration->getRemainingAmountOfSteps() > 0;
    }
}