Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

assert()

Włączone assert sprawdza prawdziwość wyrażenia i przy sukcesie zwraca true.

Wersja: PHP 8.4; repository runtime, production runtime not attested

Składnia

assert(mixed $assertion, Throwable|string|null $description = null): bool

Włączone assert sprawdza prawdziwość wyrażenia i przy sukcesie zwraca true. Przy fałszu domyślna obsługa zgłasza AssertionError z opisem tekstowym lub przekazany obiekt Throwable. Gdy zend.assertions wynosi 0 albo -1, wyrażenie może zostać pominięte, a wynikiem jest true. W PHP 8 napis jest sprawdzany jako wartość, bez wykonania zawartego w nim kodu.

Sygnatura

assert(mixed $assertion, Throwable|string|null $description = null): bool

Wynik przykładu

[1,"AssertionError","not enough"]
[0,true]

Przykłady

<?php
function executeMode(int $mode, string $source): string {
    $command = [PHP_BINARY, "-n", "-d", "zend.assertions=$mode", "-r", $source];
    $process = proc_open($command, [1 => ["pipe", "w"], 2 => ["pipe", "w"]], $pipes);
    if (!is_resource($process)) { throw new RuntimeException("start failed"); }
    $answer = stream_get_contents($pipes[1]);
    $error = stream_get_contents($pipes[2]);
    fclose($pipes[1]); fclose($pipes[2]);
    if (proc_close($process) !== 0) { throw new RuntimeException($error); }
    return $answer;
}
$src = <<<'PHP'
$n = 0;
try {
    $ok = assert(++$n > 1, "not enough");
    echo json_encode([$n, $ok]);
} catch (AssertionError $e) {
    echo json_encode([$n, get_class($e), $e->getMessage()]);
}
PHP;
echo executeMode(1, $src), PHP_EOL, executeMode(-1, $src);

Wynik

[1,"AssertionError","not enough"]
[0,true]

Źródła