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);
}
?>

Siehe auch

SoapClient->__construct()
SoapFault->__construct()