PHP Handbuch
Zurück |  | Weiter

# 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()

Zurück | Zum Anfang | Weiter
SOAP Funktionen | Nach oben | SoapClient->__call()