(PHP 5, PHP 7)
is_soap_fault — Prüft, ob ein SOAP-Aufruf fehlgeschlagen ist
Diese Funktion is 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, dass 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.
objectDas 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);
}
?>