PHP 7 - Expectativas
Expectationssão um aprimoramento compatível com versões anteriores da função assert () mais antiga. A expectativa permite asserções de custo zero no código de produção e fornece a capacidade de lançar exceções customizadas quando a asserção falha. assert () é agora uma construção de linguagem, onde o primeiro parâmetro é uma expressão em comparação a ser uma string ou booleano a ser testado.
Diretivas de configuração para assert ()
| Diretriz | Valor padrão | Valores possíveis |
|---|---|---|
| zend.assertions | 1 | 1 - gerar e executar código (modo de desenvolvimento) 0 - gerar código, mas pular em tempo de execução -1 - não gerar código (modo de produção) |
| assert.exception | 0 | 1 - lançar, quando a afirmação falhar, seja lançando o objeto fornecido como exceção ou lançando um novo AssertionError objeto se a exceção não foi fornecida. 0 - use ou gere um Throwable conforme descrito acima, mas apenas gera um aviso baseado naquele objeto ao invés de lançá-lo (compatível com o comportamento do PHP 5) |
Parâmetros
assertion- A afirmação. No PHP 5, deve ser uma string a ser avaliada ou um Booleano a ser testado. No PHP 7, também pode ser qualquer expressão que retorna um valor, que será executado e o resultado é usado para indicar se a asserção foi bem-sucedida ou falhou.
description - Uma descrição opcional que será incluída na mensagem de falha, se a asserção falhar.
exception - No PHP 7, o segundo parâmetro pode ser um Throwable objeto em vez de uma string descritiva, caso em que este é o objeto que será lançado, se a declaração falhar e o assert.exception a diretiva de configuração está habilitada.
Valores Retornados
FALSE se a afirmação for falsa, TRUE de outra forma.
Exemplo
<?php
ini_set('assert.exception', 1);
class CustomError extends AssertionError {}
assert(false, new CustomError('Custom Error Message!'));
?>Ele produz a seguinte saída do navegador -
Fatal error: Uncaught CustomError: Custom Error Message! in...