DirectoryCreatedObjective.php

Go to the documentation of this file.

<?php

declare(strict_types=1);

namespace ILIAS\Setup\Objective;

use ILIAS\Setup;

class DirectoryCreatedObjective implements Setup\Objective
{
    public const DEFAULT_DIRECTORY_PERMISSIONS = 0755;

    protected string $path;
    protected int $permissions;

    public function __construct(
        string $path,
        int $permissions = self::DEFAULT_DIRECTORY_PERMISSIONS
    ) {
        if ($path == "") {
            throw new \InvalidArgumentException(
                "Path is empty."
            );
        }
        $this->path = $path;
        $this->permissions = $permissions;
    }

    public function getHash(): string
    {
        return hash("sha256", self::class . "::" . $this->path);
    }

    public function getLabel(): string
    {
        return "Create directory '$this->path'";
    }

    public function isNotable(): bool
    {
        return true;
    }

    public function getPreconditions(Setup\Environment $environment): array
    {
        if (file_exists($this->path)) {
            return [];
        }
        return [
            new Setup\Condition\CanCreateDirectoriesInDirectoryCondition(dirname($this->path))
        ];
    }

    public function achieve(Setup\Environment $environment): Setup\Environment
    {
        @mkdir($this->path, $this->permissions);

        if (!is_dir($this->path)) {
            throw new Setup\UnachievableException(
                "Could not create directory '$this->path'"
            );
        }
        return $environment;
    }

    public function isApplicable(Setup\Environment $environment): bool
    {
        return !file_exists($this->path);
    }
}