Funkcje callback
****************
.[perex]
[api:Nette\Utils\Callback] to klasa statyczna zawierająca funkcje do pracy z [callbackami PHP |https://www.php.net/manual/en/language.types.callable.php].
Instalacja:
```shell
composer require nette/utils
```
Wszystkie przykłady zakładają, że zdefiniowany jest następujący alias klasy:
```php
use Nette\Utils\Callback;
```
check($callable, bool $syntax=false): callable .[method]
--------------------------------------------------------
Sprawdza, czy `$callable` jest prawidłowym callbackiem PHP. W przeciwnym razie zgłasza `Nette\InvalidArgumentException`. Jeśli `$syntax` ma wartość `true`, funkcja sprawdza tylko, czy `$callable` ma prawidłową strukturę callbacku, ale nie sprawdza, czy klasa albo metoda rzeczywiście istnieje. Zwraca pierwotny `$callable`.
```php
Callback::check('trim'); // bez wyjątku
Callback::check(['NonExistentClass', 'method']); // zgłasza Nette\InvalidArgumentException
Callback::check(['NonExistentClass', 'method'], true); // bez wyjątku
Callback::check(function () {}); // bez wyjątku
Callback::check(null); // zgłasza Nette\InvalidArgumentException
```
toString(callable $callable): string .[method]
----------------------------------------------
Konwertuje callback PHP na jego reprezentację tekstową. Klasa ani metoda nie muszą istnieć.
```php
Callback::toString('trim'); // 'trim'
Callback::toString(['MyClass', 'method']); // 'MyClass::method'
```
toReflection(callable $callable): \ReflectionMethod|\ReflectionFunction .[method]
---------------------------------------------------------------------------------
Zwraca refleksję metody albo funkcji użytej w callbacku PHP. Zgłasza `\ReflectionException`, jeśli przywoływana metoda albo funkcja nie istnieje.
```php
$ref = Callback::toReflection('trim');
// $ref to ReflectionFunction('trim')
$ref = Callback::toReflection(['MyClass', 'method']);
// $ref to ReflectionMethod('MyClass', 'method')
```
isStatic(callable $callable): bool .[method]
--------------------------------------------
Sprawdza, czy callback PHP jest funkcją globalną albo metodą statyczną.
```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]
---------------------------------------------------
Rozpakowuje domknięcie utworzone przez `Closure::fromCallable()`. Zwraca pierwotną tablicę albo string callbacku.
```php
$closure = Closure::fromCallable(['MyClass', 'method']);
Callback::unwrap($closure); // ['MyClass', 'method']
```
invokeSafe(string $function, array $args, callable $onError): mixed .[method]
-----------------------------------------------------------------------------
Wywołuje natywną funkcję PHP `$function` z argumentami `$args`, przechwytując własnym handlerem wszystkie ostrzeżenia i błędy, które ona zgłosi. Pozwala to zareagować na problemy, o których natywne funkcje normalnie informują tylko ostrzeżeniem. Callback `$onError` otrzymuje dwa argumenty: komunikat błędu (z usuniętym wiodącym prefiksem `function():`) i jego wagę. Jeśli zwróci `false`, błąd zostanie przekazany do standardowego handlera błędów.
```php
$result = Callback::invokeSafe('file_get_contents', ['file.txt'], function (string $message, int $severity) {
throw new Exception($message);
});
```
Funkcje callback
Nette\Utils\Callback to klasa
statyczna zawierająca funkcje do pracy z callbackami
PHP.
Instalacja:
composer require nette/utils
Wszystkie przykłady zakładają, że zdefiniowany jest następujący alias klasy:
use Nette\Utils\Callback;
check ($callable, bool $syntax=false): callable
Sprawdza, czy $callable jest prawidłowym callbackiem PHP. W przeciwnym razie zgłasza
Nette\InvalidArgumentException. Jeśli $syntax ma wartość true, funkcja sprawdza tylko,
czy $callable ma prawidłową strukturę callbacku, ale nie sprawdza, czy klasa albo metoda rzeczywiście istnieje.
Zwraca pierwotny $callable.
Callback::check('trim'); // bez wyjątku
Callback::check(['NonExistentClass', 'method']); // zgłasza Nette\InvalidArgumentException
Callback::check(['NonExistentClass', 'method'], true); // bez wyjątku
Callback::check(function () {}); // bez wyjątku
Callback::check(null); // zgłasza Nette\InvalidArgumentException
toString (callable $callable): string
Konwertuje callback PHP na jego reprezentację tekstową. Klasa ani metoda nie muszą istnieć.
Callback::toString('trim'); // 'trim'
Callback::toString(['MyClass', 'method']); // 'MyClass::method'
toReflection (callable $callable): \ReflectionMethod|\ReflectionFunction
Zwraca refleksję metody albo funkcji użytej w callbacku PHP. Zgłasza \ReflectionException, jeśli przywoływana
metoda albo funkcja nie istnieje.
$ref = Callback::toReflection('trim');
// $ref to ReflectionFunction('trim')
$ref = Callback::toReflection(['MyClass', 'method']);
// $ref to ReflectionMethod('MyClass', 'method')
isStatic (callable $callable): bool
Sprawdza, czy callback PHP jest funkcją globalną albo metodą statyczną.
Callback::isStatic('trim'); // true
Callback::isStatic(['MyClass', 'method']); // true
Callback::isStatic([$obj, 'method']); // false
Callback::isStatic(function () {}); // false
unwrap (\Closure $closure): callable|array
Rozpakowuje domknięcie utworzone przez Closure::fromCallable(). Zwraca pierwotną tablicę albo string
callbacku.
$closure = Closure::fromCallable(['MyClass', 'method']);
Callback::unwrap($closure); // ['MyClass', 'method']
invokeSafe (string $function, array $args,
callable $onError): mixed
Wywołuje natywną funkcję PHP $function z argumentami $args, przechwytując własnym handlerem
wszystkie ostrzeżenia i błędy, które ona zgłosi. Pozwala to zareagować na problemy, o których natywne funkcje normalnie
informują tylko ostrzeżeniem. Callback $onError otrzymuje dwa argumenty: komunikat błędu (z usuniętym wiodącym
prefiksem function():) i jego wagę. Jeśli zwróci false, błąd zostanie przekazany do standardowego
handlera błędów.
$result = Callback::invokeSafe('file_get_contents', ['file.txt'], function (string $message, int $severity) {
throw new Exception($message);
});