Callback Fonksiyonları
**********************
.[perex]
[api:Nette\Utils\Callback], [PHP callback'leriyle |https://www.php.net/manual/en/language.types.callable.php] çalışmaya yarayan fonksiyonlar içeren statik bir sınıftır.
Kurulum:
```shell
composer require nette/utils
```
Tüm örnekler, aşağıdaki sınıf takma adının tanımlandığını varsayar:
```php
use Nette\Utils\Callback;
```
check($callable, bool $syntax=false): callable .[method]
--------------------------------------------------------
`$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.
```php
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 .[method]
----------------------------------------------
Bir PHP callback'ini metinsel temsiline dönüştürür. Sınıfın veya metodun var olması gerekmez.
```php
Callback::toString('trim'); // 'trim'
Callback::toString(['MyClass', 'method']); // 'MyClass::method'
```
toReflection(callable $callable): \ReflectionMethod|\ReflectionFunction .[method]
---------------------------------------------------------------------------------
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.
```php
$ref = Callback::toReflection('trim');
// $ref, ReflectionFunction('trim') nesnesidir
$ref = Callback::toReflection(['MyClass', 'method']);
// $ref, ReflectionMethod('MyClass', 'method') nesnesidir
```
isStatic(callable $callable): bool .[method]
--------------------------------------------
PHP callback'inin genel bir fonksiyon mu yoksa statik bir metot mu olduğunu denetler.
```php
Callback::isStatic('trim'); // true
Callback::isStatic(['MyClass', 'method']); // true
Callback::isStatic([$obj, 'method']); // false
Callback::isStatic(function () {}); // false
```
unwrap(\Closure $closure): callable|array .[method]
---------------------------------------------------
`Closure::fromCallable()` ile oluşturulmuş bir closure'ın sargısını açar. Özgün callable diziyi veya dizeyi döndürür.
```php
$closure = Closure::fromCallable(['MyClass', 'method']);
Callback::unwrap($closure); // ['MyClass', 'method']
```
invokeSafe(string $function, array $args, callable $onError): mixed .[method]
-----------------------------------------------------------------------------
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.
```php
$result = Callback::invokeSafe('file_get_contents', ['file.txt'], function (string $message, int $severity) {
throw new Exception($message);
});
```
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);
});