Assert

From mediawiki.org
This page is a translated version of the page Assert and the translation is 100% complete.

Assert è una libreria PHP che fornisce un'alternativa a assert() di PHP, consentendo un modo semplice e affidabile per verificare le precondizioni e le postcondizioni nel codice PHP. È stato proposto come MediaWiki RFC, ma è completamente generico e può essere usato da qualsiasi programma o libreria PHP.

Uso

La classe Assert fornisce diversi metodi statici per verificare vari tipi di asserzioni. Il genere più comune è quello di verificare il tipo di un parametro, solitamente in un costrutto o in un metodo 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 );
}

La verifica dei parametri o di altri assert, come le pre o postcondizioni, non è consigliata per le regioni del codice critiche dal punto di vista delle prestazioni, poiché la valutazione delle espressioni e la chiamata delle funzioni di assert comportano un costo in termini di tempo.

Collegamenti esterni