SoapFault::__construct
There are only a few legitimate "codes" that a SOAP fault can have and be understood by most clients in accordance with the protocol. You can't just pass in, for example, a database error code or you'll get a fatal error like "SoapFault::__construct(): Invalid parameters. Invalid fault code."
The ones you generally want to use are "Sender" where you've gotten bad parameters, or "Receiver" where the server has gotten an error for some reason.
See here:
http://www.w3.org/TR/soap12-part1/#faultcodes
SoapFault::SoapFault
(PHP 5 >= 5.0.1)
SoapFault::SoapFault — SoapFault constructor
Description
SoapFault::SoapFault
( string $faultcode
, string $faultstring
[, string $faultactor
[, string $detail
[, string $faultname
[, string $headerfault
]]]] )
This class is used to send SOAP fault responses from the PHP handler. faultcode , faultstring , faultactor and details are standard elements of a SOAP Fault.
Parameters
- faultcode
-
The error code of the SoapFault.
- faultstring
-
The error message of the SoapFault.
- faultactor
-
A string identifying the actor that caused the error.
- detail
-
More details about the cause of the error.
- faultname
-
Can be used to select the proper fault encoding from WSDL.
- headerfault
-
Can be used during SOAP header handling to report an error in the response header.
Examples
Example #1 Some examples
<?php
function test($x)
{
return new SoapFault("Server", "Some error message");
}
$server = new SoapServer(null, array('uri' => "http://test-uri/"));
$server->addFunction("test");
$server->handle();
?>
It is possible to use PHP exception mechanism to throw SOAP Fault.
Example #2 Some examples
<?php
function test($x)
{
throw new SoapFault("Server", "Some error message");
}
$server = new SoapServer(null, array('uri' => "http://test-uri/"));
$server->addFunction("test");
$server->handle();
?>
See Also
- SoapServer::fault - Issue SoapServer fault indicating an error
- is_soap_fault() - Checks if a SOAP call has failed
add a note
User Contributed NotesSoapFault::SoapFault
del at babel dot com dot au
14-Jul-2008 07:10
14-Jul-2008 07:10