WithHandler v1.0.1
Runtime: метаданные #[With]/#[WithItem], handles() и call().
Описание: Статический runtime-хелпер для виртуальных fluent-методов. Строит и кэширует метаданные операций по runtime-классу, проверяет типы дескрипторов и мутирует свойства через closures, привязанные к declaring class.
Namespace: Devcraft\Runtime
С версии: 1.0.0
См. также:
Методы
static handles(object $target, string $methodName): bool
Описание: Есть ли виртуальная операция для $methodName (регистронезависимо) на классе $target.
Параметры:
| Параметр | Тип | Описание |
|---|---|---|
$target | object | Экземпляр с атрибутами #[With] / #[WithItem] |
$methodName | string | Имя виртуального метода |
Возвращает: bool
static call(object $target, string $methodName, array $arguments): object
Описание: Выполняет виртуальную операцию и возвращает $target (для chaining).
Параметры:
| Параметр | Тип | Описание |
|---|---|---|
$target | object | Экземпляр с атрибутами |
$methodName | string | Имя виртуального метода |
$arguments | array | Аргументы (set/append — 1; map — 2) |
Возвращает: object — тот же $target
Исключения:
BadMethodCallException— неизвестный методArgumentCountError— неверное число аргументовTypeError— значение не проходит дескрипторLogicException— битая конфигурация / неинициализированный array
Виды операций
| Kind | Источник | Аргументы |
|---|---|---|
set | #[With] | ($value) |
append | #[WithItem] с 1 дескриптором | ($item) |
map | #[WithItem] с 2 дескрипторами | ($key, $value) |
Кэш
Метаданные строятся один раз на class-string и переиспользуются. Writers — closures bound to declaring class, чтобы private-свойства родителей оставались записываемыми.