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);
    }
}