Jump to content

Assert

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

Assert je PHP knihovna, která poskytuje alternativu k PHP knihovně assert() a umožňuje jednoduchý a spolehlivý způsob kontroly předběžných a postpodmínek v PHP kódu. Byl navržen jako MediaWiki RFC, ale je zcela generický a lze jej použít v jakémkoli PHP programu nebo knihovně.

Použití

Třída Assert poskytuje několik statických metod pro kontrolu různých druhů tvrzení (asercí). Nejběžnějším typem je kontrola typu parametru, obvykle v konstruktoru nebo metodě 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 );
}

Kontrola parametrů nebo jiných asercí, jako jsou pre- nebo post-podmínky, se nedoporučuje pro oblasti kódu kritické z hlediska výkonu, protože vyhodnocování výrazů a volání funkcí asercí stojí čas.

Externí odkazy