PHP Conference Japan 2024

is_soap_fault

(PHP 5, PHP 7, PHP 8)

is_soap_fault检查 SOAP 调用是否失败

描述

is_soap_fault(混合 $object): 布尔值

此函数用于检查 SOAP 调用是否失败,但不使用异常。要使用它,请创建一个 SoapClient 对象,并将 exceptions 选项设置为零或 false。在这种情况下,SOAP 方法将返回一个特殊的 SoapFault 对象,该对象封装了错误详细信息(faultcode、faultstring、faultactor 和 faultdetails)。

如果未设置 exceptions,则 SOAP 调用将在出错时抛出异常。is_soap_fault() 检查给定参数是否为 SoapFault 对象。

参数

object

要测试的对象。

返回值

出错时返回 true,否则返回 false

示例

示例 #1 is_soap_fault() 示例

<?php
$client
= new SoapClient("some.wsdl", array('exceptions' => 0));
$result = $client->SomeFunction();
if (
is_soap_fault($result)) {
trigger_error("SOAP 错误: (faultcode: {$result->faultcode}, faultstring: {$result->faultstring})", E_USER_ERROR);
}
?>

示例 #2 SOAP 的标准错误报告方法是异常

<?php
try {
$client = new SoapClient("some.wsdl");
$result = $client->SomeFunction(/* ... */);
} catch (
SoapFault $fault) {
trigger_error("SOAP 错误: (faultcode: {$fault->faultcode}, faultstring: {$fault->faultstring})", E_USER_ERROR);
}
?>

参见

添加注释

用户贡献的注释

此页面没有用户贡献的注释。
To Top