Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / PHP

assert()

Un assert actif teste la vérité de l’expression et renvoie true en cas de succès.

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

Syntaxe

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

Un assert actif teste la vérité de l’expression et renvoie true en cas de succès. En cas d’échec le comportement par défaut lève AssertionError avec le message ou le Throwable fourni. Avec zend.assertions à 0 ou -1 l’expression peut être ignorée et le résultat vaut true. PHP 8 teste une chaîne comme valeur sans exécuter son contenu.

Signature

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

Sortie de l’exemple

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

Exemples

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

Résultat

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

Sources