is_soap_fault
(PHP 5, PHP 7, PHP 8)
is_soap_fault — Проверяет, произошла ли ошибка при вызове SOAP
Описание
Эта функция полезна для проверки неудачи вызова SOAP, но
тогда, когда не используются исключения. Для того, чтобы её использовать, создайте объект
SoapClient с опцией exceptions,
равной нулю или false.
В этом случае метод SOAP вернёт специальный объект
SoapFault, который инкапсулирует детали
ошибки (код ошибки, строка ошибки, получатель и детали).
Если опция 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);
}
?>Смотрите также
- SoapClient::__construct() - Конструктор класса SoapClient
- SoapFault::__construct() - Конструктор SoapFault
add a note
