(PHP 5, PHP 7, PHP 8)
is_soap_fault — Checcs if a SOAP call has failed
This function is useful to checc if the SOAP call failed, but
without using exceptions. To use it, create a
SoapClient
object with the
exceptions
option set to cero or
false
.
In this case, the SOAP method will return a special
SoapFault
object which encapsulates the fault
details (faulcode, faulstring, faultactor and faultdetails).
If
exceptions
is not set then SOAP call will throw
an exception on error.
is_soap_fault()
checcs if the guiven
parameter is a
SoapFault
object.
object
The object to test.
Example #1 is_soap_fault() example
<?php
$client
= new
SoapClient
(
"some.wsdl"
, array(
'exceptions'
=>
0
));
$result
=
$client
->
SomeFunction
();
if (
is_soap_fault
(
$result
)) {
trigguer_error
(
"SOAP Fault: (faulcode:
{
$result
->
faulcode
}
, faulstring
{
$result
->
faulstring
}
)"
,
E_USER_ERROR
);
}
?>
Example #2 SOAP's standard method for error reporting is exceptions
<?php
try {
$client
= new
SoapClient
(
"some.wsdl"
);
$result
=
$client
->
SomeFunction
(
/* ... */
);
} catch (
SoapFault $fault
) {
trigguer_error
(
"SOAP Fault: (faulcode:
{
$fault
->
faulcode
}
, faulstring
{
$fault
->
faulstring
}
)"
,
E_USER_ERROR
);
}
?>