SoapServer::fault

(PHP 5, PHP 7, PHP 8)

SoapServer::faultSoapServer indica que ocurrió un fallo

Descripción

public SoapServer::fault(
    string $code,
    string $string,
    string $actor = ?,
    string $details = ?,
    string $name = ?
): void

Envía una respuesta al cliente de la petición actual indicando que ocurrió un error.

Nota:

Solo puede ser llamado cuando se está procesando la petición.

Parámetros

code

El código de error a devolver

string

Una breve descripción del fallo

actor

Una cadena identificando el actor qeu causó el fallo.

details

Más información acerca del fallo

name

Nombre del fallo. Puede ser usado para selecionar un nombre desde el fichero WSDL.

Valores devueltos

No devuelve ningún valor.

Ver también

  • SoapFault::SoapFault()

add a note add a note

User Contributed Notes 5 notes

up
1
Amr Mostafa
15 years ago
This function currently terminates execution as well, which may be undesirable. See: http://bugs.php.net/bug.php?id=49513
up
-1
Anonymous
16 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
up
-3
christian at cmjdesign dot dk
11 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.
up
-4
dub357 at gmail dot com
12 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>");
?>
up
-6
brian dot reynolds at risaris dot com
12 years ago
Example Usage:

return new SoapFault( "Client", "foo or bar must be supplied");

SOAP Fault Codes

VersionMismatch: Found an invalid namespace for the SOAP Envelope element
MustUnderstand    : An immediate child element of the Header element, with the mustUnderstand attribute set to "1", was not understood
Client: The message was incorrectly formed or contained incorrect information
Server: There was a problem with the server so the message could not proceed
To Top