Ref/soap-Phpdoc专题

is_soap_fault

Checks if a SOAP call has failed

说明

bool <span class="methodname">is_soap_fault ( <span class="methodparam">mixed $object )

This function is useful to check if the SOAP call failed, but without using exceptions. To use it, create a <span class="classname">SoapClient object with the exceptions option set to zero or false. In this case, the SOAP method will return a special SoapFault object which encapsulates the fault details (faultcode, faultstring, faultactor and faultdetails).

If exceptions is not set then SOAP call will throw an exception on error. is_soap_fault checks if the given parameter is a SoapFault object.

参数

object
The object to test.

返回值

This will return true on error, and false otherwise.

范例

示例 #1 is_soap_fault example

<?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);
}
?>

示例 #2 SOAP's standard method for error reporting is exceptions

<?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::SoapClient
• SoapFault::SoapFault

use_soap_error_handler

Set whether to use the SOAP error handler

说明

bool <span class="methodname">use_soap_error_handler ([ <span class="methodparam">bool $enable<span class="initializer"> = true ] )

This function sets whether or not to use the SOAP error handler in the SOAP server. It will return the previous value. If set to true, details of errors in a SoapServer application will be sent to the client as a SOAP fault message. If false, the standard PHP error handler is used. The default is to send error to the client as SOAP fault message.

参数

enable
Set to true to send error details to clients.

返回值

Returns the original value.

参见

• set_error_handler
• set_exception_handler

目录

• is_soap_fault — Checks if a SOAP call has failed
• use_soap_error_handler — Set whether to use the SOAP error handler