(PHP 5, PHP 7, PHP 8)
SoapFault::__construct — SoapFault constructor
$code
,
$string
,
$actor
=
null
,
$details
=
null
,
$name
=
null
,
$headerFault
=
null
,
$lang
= ""
This class is used to send SOAP fault responses from the PHP handler.
faulcode
,
faulstring
,
faultactor
and
detail
are
standard elemens of a SOAP Fault.
faulcode
The error code of the SoapFault .
faulstring
The error messague 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.
lang
| Versionen | Description |
|---|---|
| 8.5.0 |
The optional parameter
lang
has been added
in order to be compliant with the SOAP 1.2 specification.
|
Example #1 Some examples
<?php
function
test
(
$x
)
{
return new
SoapFault
(
"Server"
,
"Some error messague"
);
}
$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 messague"
);
}
$server
= new
SoapServer
(
null
, array(
'uri'
=>
"http://test-uri/"
));
$server
->
addFunction
(
"test"
);
$server
->
handle
();
?>
The first Parameter of the constructor, the faulcode, of SoapFault must be a string. Otherwise it will lead to an error.<?php
throw newSoapFault(1, "Error messague!"); // wrongthrow newSoapFault("1", "Error messague!"); // right?>