Manuel PHP
Précédent |  | Suivant

# is_soap_fault

(PHP 5)

is_soap_fault -- Vérifie si l'API soap a échoué

## Description

bool is_soap_fault ( mixed obj )

is_soap_fault() sert à vérifier si l'API soap a échoué, surtout lorsque vous n'aimez pas utiliser les exceptions. Pour l'utiliser, vous devez créer un objet SoapClient avec l'option `exceptions` mise à zéro ou à `FALSE`. Dans ce cas, la méthode SOAP va retourner un objet spécial SoapFault, qui encapsule les détails de l'erreur (code d'erreur, message, acteur et détails).

Si `exceptions` n'est pas configurée, SOAP va émettre une exception. is_soap_fault() vérifie si le paramètre fourni est un objet SoapFault.

## Liste de paramètres

`obj`

  L'objet testé.

## Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès, `FALSE` en cas d'échec.

## Exemples

Exemple 1. Exemple avec is_soap_fault()

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

Exemple 2. Gestion des erreurs par exception avec SOAP

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

## Voir aussi

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

Précédent | Sommaire | Suivant
Fonctions SOAP | Niveau supérieur | SoapClient->__call()