Callback Fonksiyonları

Nette\Utils\Callback, PHP callback'leriyle çalışmaya yarayan fonksiyonlar içeren statik bir sınıftır.

Kurulum:

composer require nette/utils

Tüm örnekler, aşağıdaki sınıf takma adının tanımlandığını varsayar:

use Nette\Utils\Callback;

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

$callable değerinin geçerli bir PHP callback'i olup olmadığını denetler. Değilse Nette\InvalidArgumentException fırlatır. $syntax değeri true ise fonksiyon yalnızca $callable'ın geçerli bir callback yapısına sahip olduğunu doğrular, sınıfın veya metodun gerçekten var olup olmadığını denetlemez. Özgün $callable değerini döndürür.

Callback::check('trim'); // istisna yok
Callback::check(['NonExistentClass', 'method']); // Nette\InvalidArgumentException fırlatır
Callback::check(['NonExistentClass', 'method'], true); // istisna yok
Callback::check(function () {}); // istisna yok
Callback::check(null); // Nette\InvalidArgumentException fırlatır

toString (callable $callable): string

Bir PHP callback'ini metinsel temsiline dönüştürür. Sınıfın veya metodun var olması gerekmez.

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

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

PHP callback'inde kullanılan metot veya fonksiyon için bir reflection döndürür. Başvurulan metot ya da fonksiyon yoksa \ReflectionException fırlatır.

$ref = Callback::toReflection('trim');
// $ref, ReflectionFunction('trim') nesnesidir

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

isStatic (callable $callable): bool

PHP callback'inin genel bir fonksiyon mu yoksa statik bir metot mu olduğunu denetler.

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() ile oluşturulmuş bir closure'ın sargısını açar. Özgün callable diziyi veya dizeyi döndürür.

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

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

Yerleşik PHP fonksiyonu $function'ı $args argümanlarıyla çağırır ve bu sırada ürettiği uyarı ya da hataları kendi işleyicisiyle yakalar. Böylece yerleşik fonksiyonların normalde yalnızca uyarı olarak bildirdiği sorunlara tepki verebilirsiniz. $onError callback'i iki argüman alır: hata mesajı (baştaki function(): öneki kaldırılmış olarak) ve hatanın önem derecesi. false döndürürse hata standart hata işleyicisine aktarılır.

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