SoapServer::fault

(PHP 5, PHP 7, PHP 8)

SoapServer::fault — Сообщает о сбое SOAP-сервера из-за ошибки

Описание

public function SoapServer::fault(
    string $code,
    string $string,
    string $actor = "",
    mixed $details = null,
    string $name = "",
    string $lang = ""
): void

Метод сообщает о сбое в ответе на текущий запрос клиента и указывает причины ошибки.

Замечание:
Метод вызывают только при обработке запроса.

Список параметров

code: Код ошибки для возврата.
string: Краткое описание ошибки.
actor: Строка идентификации участника, который сгенерировал ошибку.
details: Подробности о причинах ошибки.
name: Название, которое указывает клиенту тип и структуру ошибки в WSDL-описании.
lang: Язык текста сообщения об ошибке в объекте SoapFault. Параметр учитывается только в протоколе SOAP версии 1.2.

Возвращаемые значения

Функция не возвращает значения после выполнения.

Список изменений

Версия	Описание
8.5.0	В метод добавили необязательный параметр `lang`, чтобы объект ошибки соответствовал спецификации протокола SOAP 1.2.

Смотрите также

SoapFault::__construct() - Инициализирует объект SoapFault

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 4 notes

down

Amr Mostafa ¶

16 years ago

This function currently terminates execution as well, which may be undesirable. See: http://bugs.php.net/bug.php?id=49513

down

Anonymous ¶

17 years ago

If you use Adobe Flex, Flash or AIR as SOAP client and are unable to get the error message in case of a soap fault, upgrade to PHP 5.2.6.

Details in:
http://bugs.php.net/bug.php?id=43507

down

-3

christian at cmjdesign dot dk ¶

13 years ago

hi,
to control the fault output one may do the following

/**
 * mySoapServer class
 */
class mySoapServer extends SoapServer {
    public function __construct($wsdl, array $options = null) {
        parent::SoapServer($wsdl, $options);
    }
    public function fault ($code, $string, $actor = null, $details = null, $name = null) {
        throw new SoapFault($code, $string, $actor, $details, $name);
    }
}

Use:
try {
    $server = new mySoapServer(null, array('uri' => $_SERVER['REQUEST_URI']));
    $server->setClass('mySoapAPI');
    $server->handle();
} catch (SoapFault $exc) {
    echo $exc->getTraceAsString();
}

that how i did this,
hope iot can help some one.

down

-5

dub357 at gmail dot com ¶

14 years ago

This function also sends a 500 response code back to the client with the request.
This was causing issues with an Apache Axis 1.2 client I had so I instead implemented by own fault handling:

<?php
header("Content-Type: text/xml");
header("Status: 200");
die("<SOAP-ENV:Envelope xmlns:SOAP-ENV=\\"http://schemas.xmlsoap.org/soap/envelope/\\">
  <SOAP-ENV:Body>
    <SOAP-ENV:Fault>
      <faultcode>500</faultcode>
      <faultstring>".$ex->getMessage())."</faultstring>
    </SOAP-ENV:Fault>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>");
?>

＋Добавить