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