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

## Voir aussi

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

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