Traditionelle Assertions (PHP 5 und 7)
Wird der Parameter assertion
als Zeichenkette
übergeben, so wird die Zeichenkette von assert() als
PHP-Code interpretiert. Wenn eine boolesche Bedingung als
assertion
übergeben wird, wird diese Bedingung, die
eventuell mit assert_options() definiert wurde, nicht
als Parameter an die Assertion-Funktion weitergegeben. Die Bedingung wird
in eine Zeichenkette umgewandelt, bevor die Handler-Funktion aufgerufen
wird, und das boolesche false
wird in eine leere Zeichenkette
umgewandelt.
assert() sollte nur zum Debuggen des Codes verwendet
werden. Es kann für Plausibilitätsprüfungen verwendet werden, um auf
Bedingungen zu prüfen, die immer true
sein sollten, und die andernfalls
Programmierfehler anzeigen, oder um auf die Verfügbarkeit bestimmter
Merkmale, wie Erweiterungsfunktionen oder bestimmte Systembeschränkungen
und Eigenschaften, zu prüfen.
Assertions sollten nicht für normale Laufzeitoperationen wie die
Überprüfung von Eingaben verwendet werden. Als Faustregel sollte der Code
immer korrekt funktionieren können, auch wenn die Assertion-Prüfung
deaktiviert ist.
Die Optionen für assert() können über die Funktion
assert_options() oder durch .ini-Einstellungen, die in
der Handbuchseite dieser Funktion beschrieben werden, konfiguriert werden.
Die Funktion assert_options() und/oder die
Konfigurationsoption ASSERT_CALLBACK
ermöglichen es,
eine Funktion anzugeben, die bei fehlgeschlagenen Assertions aufgerufen
wird.
Callback-Funktionen im Zusammenhang mit assert() sind
insbesondere nützlich, um beispielsweise automatisierte Tests
durchzuführen, da die Callback-Funktion über die Information verfügt, von
welcher Stelle sie aufgerufen wurde. Auch wenn diese Information mit
anderen Methoden zugänglich ist, macht es die Verwendung von Assertions
viel schneller und leichter!
Die Callback-Funktion wird mit drei Parametern aufgerufen. Der erste
Parameter enthält den Namen des Skripts, in dem die Assertion fehlschlug,
der zweite Parameter die Zeilennummer und der dritte Parameter enthält die
über assertion
angegebene Bedingung (falls
vorhanden, wobei Literale wie 1 oder "zwei" in diesem Argument nicht
übergeben werden). Nutzer von PHP 5.4.8 und höher können auch ein viertes
optionales Argument angeben, das die Beschreibung
description
enthält, die an
assert() übergeben wird.
Expectations (Annahmen) (nur PHP 7)
assert() ist in PHP 7 ein Sprachkonstrukt, das die
Definition von Expectations ermöglicht: Assertions, die in Entwicklungs-
und Testumgebungen wirken, aber so optimiert werden, dass sie in
Produktionsumgebungen keinen Mehraufwand verursachen.
Während assert_options() noch immer verwendet werden
kann, um das oben beschriebene Verhalten aus Gründen der
Abwärtskompatibilität zu steuern, sollte Code, der nur für PHP 7
geschrieben wird, die beiden neuen Konfigurationsoptionen zur Steuerung
von assert() verwenden und nicht
assert_options() aufrufen.
PHP 7 Konfigurationsoptionen für assert()
Option |
Vorgabewert |
Mögliche Werte |
zend.assertions
|
1 |
-
1 : erzeugt Code und führt ihn aus
(Entwicklungsmodus).
-
0 : erzeugt Code, aber führt ihn zur Laufzeit
nicht aus.
-
-1 : erzeugt keinen Code (Produktionsmodus).
|
assert.exception
|
0 |
-
1 : löst eine Exception aus, wenn die Assertion
fehlschlägt; entweder das Objekt, das als
exception übergeben wurde, oder ein neues
AssertionError-Objekt, wenn
exception nicht angegeben wurde.
-
0 : verwendet oder erzeugt ein
Throwable wie oben beschrieben, aber erzeugt
nur eine Warnung, die auf diesem Objekt basiert, anstatt eine
Exception auszulösen (kompatibel zum Verhalten unter PHP 5).
|