is_soap_fault
(PHP 5)
is_soap_fault --
Prüft, ob eine SOAP-Aufruf fehlgeschlagen ist.
Beschreibung
bool
is_soap_fault ( mixed obj )
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
Beispiel 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); } ?>
|
|
Beispiel 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); } ?>
|
|