is_soap_fault
(PHP 5)
is_soap_fault — Vérifie si l'API soap a échoué
Description
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
Example#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);
}
?>
Example#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);
}
?>