(PHP 5, PHP 7, PHP 8)
is_soap_fault — Verifica se uma chamada SOAP falhou
Esta função é útil para verificar se a chamada SOAP falhou, mas
sem usar exceções. Para usá-la, crie um
objeto SoapClient com a opção exceptions
definida como zero ou false
.
Neste caso, o método SOAP retornará um objeto especial
SoapFault que encapsula os detalhes da falha
(faultcode, faultstring, faultactor and faultdetails).
Se exceptions
não estiver definido então a chamada SOAP lançará
uma exceção em caso de erro.
is_soap_fault() verifica se o dado
parâmetro é um objeto SoapFault.
object
O objeto a ser testado.
Exemplo #1 Exemplo de 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);
}
?>
Exemplo #2 O método padrão do SOAP para o reporte de erros são as exceções
<?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);
}
?>