is_soap_fault
(PHP 5, PHP 7)
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::SoapClient() - Конструктор SoapClient
- SoapFault::SoapFault() - Конструктор SoapFault