Callback-функции

Nette\Utils\Callback – статический класс с функциями для работы с callback-функциями PHP.

Установка:

composer require nette/utils

Во всех примерах предполагается, что определён такой псевдоним класса:

use Nette\Utils\Callback;

check ($callable, bool $syntax=false): callable

Проверяет, является ли $callable корректным callback PHP. Иначе выбрасывает Nette\InvalidArgumentException. Если $syntax установлен в true, функция только проверяет, что у $callable корректная структура callback, но не проверяет, существуют ли класс или метод на самом деле. Возвращает исходный $callable.

Callback::check('trim'); // без исключения
Callback::check(['NonExistentClass', 'method']); // выбрасывает Nette\InvalidArgumentException
Callback::check(['NonExistentClass', 'method'], true); // без исключения
Callback::check(function () {}); // без исключения
Callback::check(null); // выбрасывает Nette\InvalidArgumentException

toString (callable $callable): string

Преобразует callback PHP в его текстовое представление. Класс или метод существовать не обязаны.

Callback::toString('trim');                // 'trim'
Callback::toString(['MyClass', 'method']); // 'MyClass::method'

toReflection (callable $callable): \ReflectionMethod|\ReflectionFunction

Возвращает рефлексию метода или функции, использованных в callback PHP. Выбрасывает \ReflectionException, если указанный метод или функция не существуют.

$ref = Callback::toReflection('trim');
// $ref - это ReflectionFunction('trim')

$ref = Callback::toReflection(['MyClass', 'method']);
// $ref - это ReflectionMethod('MyClass', 'method')

isStatic (callable $callable): bool

Проверяет, является ли callback PHP глобальной функцией или статическим методом.

Callback::isStatic('trim');                // true
Callback::isStatic(['MyClass', 'method']); // true
Callback::isStatic([$obj, 'method']);      // false
Callback::isStatic(function () {});        // false

unwrap (\Closure $closure): callable|array

Разворачивает замыкание, созданное через Closure::fromCallable(). Возвращает исходный массив или строку callable.

$closure = Closure::fromCallable(['MyClass', 'method']);
Callback::unwrap($closure);     // ['MyClass', 'method']

invokeSafe (string $function, array $args, callable $onError): mixed

Вызывает нативную функцию PHP $function с аргументами $args и при этом перехватывает собственным обработчиком все предупреждения и ошибки, которые она выдаёт. Это позволяет реагировать на проблемы, о которых нативные функции обычно сообщают лишь предупреждением. Callback $onError получает два аргумента: сообщение об ошибке (без ведущего префикса function():) и её уровень серьёзности. Если он возвращает false, ошибка передаётся стандартному обработчику ошибок.

$result = Callback::invokeSafe('file_get_contents', ['file.txt'], function (string $message, int $severity) {
	throw new Exception($message);
});