(PHP 5, PHP 7, PHP 8)
is_soap_fault — Prüft, ob ein SOAP-Aufruf fehlgeschlagen ist
Diese Funktion ist nützlich, um festzustellen, ob ein SOAP-Aufruf
fehlgeschlagen ist, aber keine Exceptions verwendet wurden. Um die Funktion
zu verwenden, muss ein SoapClient-Objekt erzeugt und
exceptions
auf 0 oder false
gesetzt werden. In diesem
Fall gibt die SOAP-Methode ein spezielles
SoapFault-Objekt zurück, das die Fehlerinformationen
enthält (Fehlercode, Fehlerbeschreibung, Verursacher und Details).
Wenn exceptions
nicht gesetzt ist, wirft der
SOAP-Aufruf im Fehlerfall eine Exception.
is_soap_fault() prüft, ob der gegebene Parameter ein
SoapFault-Objekt ist.
object
Das zu testende Objekt.
Die Funktion gibt im Fehlerfall true
, ansonsten false
zurück.
Beispiel #1 is_soap_fault()-Beispiel
<?php
$client = new SoapClient("some.wsdl", array('exceptions' => 0));
$result = $client->EineFunktion();
if (is_soap_fault($result)) {
trigger_error("SOAP-Fehler: (Fehlernummer: {$result->faultcode}, "
."Fehlermeldung: {$result->faultstring})", E_USER_ERROR);
}
?>
Beispiel #2 Die SOAP-Standardmethode zur Fehlerbehandlung ist das Werfen von Exceptions.
<?php
try {
$client = new SoapClient("ein.wsdl");
$result = $client->EineFunktion(/* ... */);
} catch (SoapFault $fault) {
trigger_error("SOAP-Fehler: (Fehlernummer: {$fault->faultcode}, "
."Fehlermeldung: {$fault->faultstring})", E_USER_ERROR);
}
?>