Assert/pt-br
Appearance
Assert é uma biblioteca PHP que fornece uma alternativa ao assert()
do PHP que permite uma maneira simples e confiável de verificar pré-condições e pós-condições no código PHP.
Foi proposto como um MediaWiki RFC, mas é completamente genérico e pode ser usado por qualquer programa ou biblioteca PHP.
Uso
A classe Assert fornece vários métodos estáticos para verificar vários tipos de asserções. O tipo mais comum é verificar o tipo de um parâmetro, normalmente em um construtor ou método setter:
use Wikimedia\Assert\Assert;
function setFoo( $foo ) {
Assert::parameterType( 'integer', $foo, 'foo' );
Assert::parameter( $foo > 0, 'foo', 'must be greater than 0' );
}
function __construct( $bar, array $bazz ) {
Assert::parameterType( 'Me\MyApp\SomeClass', $bar );
Assert::parameterElementType( 'int', $bazz );
}
A verificação de parâmetros ou outras asserções, como pré ou pós-condições, não é recomendada para regiões críticas de desempenho do código, pois avaliar expressões e chamar as funções de asserção custa tempo.