Просмотр архива ROTOR 14.1.1


<?php

declare(strict_types=1);

namespace AppClasses;

use Stringable;

class Hook
{
    private static array $hooks = [];
    private static array $dirty = [];

    /**
     * Возвращает все хуки
     */
    public static function getHooks(): array
    {
        return self::$hooks;
    }

    /**
     * Добавляет хук
     *
     * Принимает строку/Stringable или callable вида fn(mixed $args = null): string|Stringable|null.
     * Чем выше priority, тем раньше хук выводится.
     */
    public static function add(string $hookName, string|Stringable|callable $value, int $priority = 0): void
    {
        if (! isset(self::$hooks[$hookName])) {
            self::$hooks[$hookName] = [];
        }

        self::$hooks[$hookName][] = [
            'value'    => $value,
            'priority' => $priority,
        ];

        self::$dirty[$hookName] = true;
    }

    /**
     * Проверяет, зарегистрирован ли хук
     */
    public static function has(string $hookName): bool
    {
        return ! empty(self::$hooks[$hookName]);
    }

    /**
     * Вызывает хук
     */
    public static function call(string $hookName, mixed ...$args): string
    {
        if (self::$dirty[$hookName] ?? false) {
            usort(self::$hooks[$hookName], static fn ($a, $b) => $b['priority'] <=> $a['priority']);
            unset(self::$dirty[$hookName]);
        }

        $result = '<!--@' . $hookName . '-->';

        foreach (self::$hooks[$hookName] ?? [] as $hook) {
            $value = $hook['value'];
            $fragment = (is_string($value) || $value instanceof Stringable) ? $value : $value(...$args);

            if ($fragment === null || $fragment === '') {
                continue;
            }

            $result .= $fragment . PHP_EOL;
        }

        return $result;
    }
}