Funcții auxiliare

Nette\Utils\Helpers este o clasă statică cu funcții utile.

Instalare:

composer require nette/utils

Toate exemplele presupun crearea unui alias:

use Nette\Utils\Helpers;

capture (callable $cb): string

Execută callback-ul și returnează ieșirea capturată ca șir.

$res = Helpers::capture(function () use ($template) {
	$template->render();
});

clamp (int|float $value, int|float $min, int|float $max): int|float

Limitează valoarea la intervalul inclusiv dat min și max.

Helpers::clamp($level, 0, 255);

compare (mixed $left, string $operator, mixed $right): bool

Compară două valori în același mod în care o face PHP. Distinge operatorii >, >=, <, <=, =, ==, ===, !=, !==, <>. Funcția este utilă în situații în care operatorul este variabil.

Helpers::compare(10, '<', 20); // true

falseToNull (mixed $value): mixed

Convertește false la null, alte valori nu le modifică.

Helpers::falseToNull(false); // null
Helpers::falseToNull(123);   // 123

getLastError(): string

Returnează ultima eroare din PHP sau un șir gol dacă nu a apărut nicio eroare. Spre deosebire de error_get_last(), nu este influențată de directiva PHP html_errors și returnează întotdeauna text, nu HTML.

Helpers::getLastError();

getSuggestion (string[] $possibilities, string $value): ?string

Din opțiunile oferite $possibilities, caută șirul care este cel mai similar cu $value, dar nu identic. Suportă doar codificări pe 8 biți.

Este util în cazul în care o anumită opțiune nu este validă și dorim să îi sugerăm utilizatorului una similară (dar diferită, de aceea se ignoră șirul identic). În acest mod, Nette creează mesajele did you mean ...?.

$items = ['foo', 'bar', 'baz'];
Helpers::getSuggestion($items, 'fo');   // 'foo'
Helpers::getSuggestion($items, 'barr'); // 'bar'
Helpers::getSuggestion($items, 'baz');  // 'bar', nu 'baz'