Edit Report a Bug

    The SoapFault class

    (PHP 5, PHP 7)

    Introducere

    Represents a SOAP fault.

    Sinopsisul clasei

    SoapFault extends Exception {
    /* Proprietăți moștenite */
    protected string $message ;
    protected int $code ;
    protected string $file ;
    protected int $line ;
    /* Metode */
    public __construct ( array|string|null $code , string $string , string|null $actor = null , mixed $details = null , string|null $name = null , mixed $headerFault = null )
    SoapFault ( string $faultcode , string $faultstring , string $faultactor = ? , string $detail = ? , string $faultname = ? , string $headerfault = ? )
    public __toString ( ) : string
    /* Metode moștenite */
    final public Exception::getMessage ( ) : string
    final public Exception::getPrevious ( ) : Throwable
    final public Exception::getCode ( ) : mixed
    final public Exception::getFile ( ) : string
    final public Exception::getLine ( ) : int
    final public Exception::getTrace ( ) : array
    final public Exception::getTraceAsString ( ) : string
    public Exception::__toString ( ) : string
    final private Exception::__clone ( ) : void
    }

    Cuprins

    add a note add a note

    User Contributed Notes 3 notes

    up
    39
    dmitry dot koterov at gmail dot com
    15 years ago
    You may use undocumented and invisible property $e->faultcode to access string version of $code. Because standard $e->getCode() does not work:

    <?php
    $e     = new SoapFault("test", "msg");
    var_dump($e->getCode()); // prints "0"
    var_dump($e->faultcode); // prints "test"
    ?>

    Also you may use namespaced fault codes:

    <?php
    $e     = new SoapFault(array("namespace", "test"), "msg");
    ?>

    - see ext/soap/soap.php, PHP_METHOD(SoapFault, SoapFault). To access the namespace, use $e->faultcodens
    up
    9
    chris AT cmbuckley DOT co DOT uk
    14 years ago
    A bit more digging in ext/soap/soap.c and the set_soap_fault function reveals the other undocumented properties from the constructor:

    <?php
    try {
        throw new     SoapFault('code', 'string', 'actor', 'detail', 'name', 'header');
    } catch (    Exception $ex) {
            var_dump($ex->faultcode, $ex->faultstring, $ex->faultactor, $ex->detail, $ex->_name, $ex->headerfault);
    }
    ?>
    up
    1
    fbernoldi at gmail dot com
    12 years ago
    Hi all,

    I've decided to post this since it may be helpful, I've spend a couple of days trying to do this.

    In order to use wsdl's specified faults with complex types, i.e:

    WSDL definitions:

    (xsd:schema namespace, ns1 = target namespace)

    <xsd:element name="doubleFault">
      <xsd:complexType>
        <xsd:sequence>
          <xsd:element name="detail1" type="xsd:string"/>
          <xsd:element name="detail2" type="xsd:string"/>
        </xsd:sequence>
      </xsd:complexType>
    </xsd:element>

    WSDL messages:

    <message name="fault_specified">
        <part name="relevant_name" element="ns1:doubleFault"/>
    </message>

    WSDL port type:

    <portType name="test">
      <operation name="operationTest">
      <input message="ns1:not_relevant_request"/>
      <output message="ns1:not_relevant_response"/>
      <fault name="FaultSpecified" message="ns1:fault_specified"/>
      ....
    </portType>

    You have to specify the response in the detail parameter as an array corresponding the tag names.

    PHP Code:

    <?php

    function operationTest($request_param ...) {

            // ...
            $array_details = array("detail1" => "Explanation 1", "detail2" => "Explanation 2");
       
        return new     SoapFault("Server", "example fault string", null, $array_details, "FaultSpecified");

    }

    $server = new SOAPServer("handmade.wsdl");
    $server->addFunction("operationTest");
    $server->handle();

    ?>

    that should respond something like this:

    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://mynamespace">
       <SOAP-ENV:Body>
          <SOAP-ENV:Fault>
             <faultcode>SOAP-ENV:Server</faultcode>
             <faultstring>example fault string</faultstring>
             <detail>
                <ns1:doubleFault>
                   <detail1>Explanation 1</detail1>
                   <detail2>Explanation 2</detail2>
                </ns1:doubleFault>
             </detail>
          </SOAP-ENV:Fault>
       </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

    I Hope it helps,
    Federico.
    add a note add a note
    To Top