コールバックの操作

Nette\Utils\Callback は、PHPコールバック を操作するための関数を持つ静的クラスです。

インストール：

composer require nette/utils

以下の例では、エイリアスが作成されていることを前提としています：

use Nette\Utils\Callback;

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

変数 $callable が有効なコールバックであるかどうかをチェックします。そうでない場合は Nette\InvalidArgumentException をスローします。$syntax が true の場合、関数は単に $callable がコールバックの構造を持っていることを検証しますが、指定されたクラスやメソッドが実際に存在するかどうかは検証しません。$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): string

PHPコールバックをテキスト形式に変換します。クラスやメソッドは存在する必要はありません。

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

toReflection ($callable): ReflectionMethod|ReflectionFunction

PHPコールバック内のメソッドまたは関数のリフレクションを返します。

$ref = Callback::toReflection('trim');
// $ref は ReflectionFunction('trim') です

$ref = Callback::toReflection(['MyClass', 'method']);
// $ref は ReflectionMethod('MyClass', 'method') です

isStatic ($callable): bool

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 を使用して作成されたClosureを逆展開します。

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