(PHP 5)
is_soap_fault — Vérifie si l'API soap a échoué
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
.
L'objet testé.
Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.
Exemple 2443. 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 2444. 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
);
}
?>
| SoapClient->__construct() |
| SoapFault->__construct() |