Manuel PHP
PrécédentSuivant

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.

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::SoapClient(), et SoapFault::SoapFault().

PrécédentSommaireSuivant
SoapVar::SoapVarNiveau supérieurSQLite