WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

assert()

Aktives assert prüft den Wahrheitswert und liefert bei Erfolg true.

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

Syntax

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

Aktives assert prüft den Wahrheitswert und liefert bei Erfolg true. Bei Fehlschlag wirft das Standardverhalten AssertionError mit Beschreibung oder das übergebene Throwable. Bei zend.assertions gleich 0 oder -1 kann der Ausdruck entfallen und das Ergebnis ist true. PHP 8 prüft Zeichenketten als Werte ohne ihren Inhalt als Code auszuführen.

Signatur

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

Ausgabe des Beispiels

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

Beispiele

<?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);

Ergebnis

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

Quellen