Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

assert()

Um assert ativo testa a veracidade da expressão e devolve true no sucesso.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

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

Um assert ativo testa a veracidade da expressão e devolve true no sucesso. Na falha o comportamento predefinido lança AssertionError com a mensagem ou o Throwable fornecido. Com zend.assertions a 0 ou -1 a expressão pode ser ignorada e o resultado é true. O PHP 8 testa cadeias como valores sem executar o seu conteúdo.

Assinatura

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

Saída do exemplo

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

Exemplos

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

Resultado

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

Fontes