is_soap_fault
(PHP 5)
is_soap_fault — Prüft, ob eine SOAP-Aufruf fehlgeschlagen ist.
Beschreibung
Diese Funktion is sinnvoll, um festzustellen, ob ein SOAP-Aufruf fehlgeschlagen ist und keine Exceptions verwendet werden sollen. Um es zu verwenden muss ein SoapClient-Objekt erzeugt werden 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.
Parameter Liste
- obj
-
Das zu testende Objekt.
Rückgabewerte
Gibt bei Erfolg TRUE zurück, im Fehlerfall FALSE.
Beispiele
Example#1 is_soap_fault() Beispiel
<?php
$client = new SoapClient("some.wsdl", array('exceptions' => 0));
$result = $client->SomeFunction();
if (is_soap_fault($result)) {
trigger_error("SOAP Fault: (faultcode: {$result->faultcode}, faultstring: {$result->faultstring})", E_USER_ERROR);
}
?>
Example#2 In der Grundeinstellung verwendet die Fehlerbehandlung des SOA-Protokolls Exceptions.
<?php
try {
$client = new SoapClient("some.wsdl");
$result = $client->SomeFunction(/* ... */);
} catch (SoapFault $fault) {
trigger_error("SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault->faultstring})", E_USER_ERROR);
}
?>