Assert

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

Assert to biblioteka PHP stanowiąca alternatywę dla assert() PHP, która pozwala w prosty i niezawodny sposób sprawdzać warunki wstępne i warunki końcowe w kodzie PHP. Został on zaproponowany jako MediaWiki RFC, ale jest całkowicie ogólny i może być używany przez dowolny program lub bibliotekę PHP.

Użycie

Klasa Assert udostępnia kilka statycznych metod do sprawdzania różnych rodzajów asercji. Najczęstszym rodzajem jest sprawdzanie typu parametru, zazwyczaj w konstruktorze lub metodzie ustawiającej:

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

Sprawdzanie parametrów lub innych asercji, takich jak warunki wstępne lub końcowe, nie jest zalecane w krytycznych pod względem wydajności regionach kodu, ponieważ obliczanie wyrażeń i wywoływanie funkcji asercji kosztuje czas.

Linki zewnętrzne