SOAP

• Introduction
• Installing/Configuring
  • Installation
  • Runtime Configuration
  • Resource Types
• Predefined Constants
• SOAP Functions
  • is_soap_fault — Checks if SOAP call was failed
  • SoapClient->__call() — Calls a SOAP function (deprecated)
  • SoapClient->__construct() — SoapClient constructor
  • SoapClient->__doRequest() — Performs a SOAP request
  • SoapClient->__getFunctions() — Returns list of SOAP functions
  • SoapClient->__getLastRequest() — Returns last SOAP request
  • SoapClient->__getLastRequestHeaders() — Returns last SOAP request headers
  • SoapClient->__getLastResponse() — Returns last SOAP response.
  • SoapClient->__getLastResponseHeaders() — Returns last SOAP response headers.
  • SoapClient->__getTypes() — Returns list of SOAP types
  • SoapClient->__setCookie() — Sets the cookie that will be sent with the SOAP request
  • SoapClient->__soapCall() — Calls a SOAP function
  • SoapFault->__construct() — SoapFault constructor
  • SoapHeader->__construct() — SoapHeader constructor
  • SoapParam->__construct() — SoapParam constructor
  • SoapServer->addFunction() — Adds one or several functions those will handle SOAP requests
  • SoapServer->__construct() — SoapServer constructor
  • SoapServer->fault() — Issue SoapServer fault indicating an error
  • SoapServer->getFunctions() — Returns list of defined functions
  • SoapServer->handle() — Handles a SOAP request
  • SoapServer->setClass() — Sets class which will handle SOAP requests
  • SoapServer->setPersistence() — Sets persistence mode of SoapServer
  • SoapVar->__construct() — SoapVar constructor
  • use_soap_error_handler — Set whether to use the SOAP error handler and return the former value

add a note User Contributed Notes
SOAP

aeg at mallxs dot nl
28-May-2008 06:19

SoapFault exception: [SOAP-ENV:Client] looks like we got no XML document

This error can have to reasons:
1: Your server script has some hidden output like spaces before or afher <?php ... ?> or echoing some text
2: You have a bug in your server script;
    resulting in a error message output

Test your server script by calling it direct  from the browser.
The result should be a clean output like :

−<SOAP-ENV:Envelope>
−<SOAP-ENV:Body>
−<SOAP-ENV:Fault>
  <faultcode>SOAP-ENV:Server</faultcode>
  <faultstring>Bad Request. Can't find HTTP_RAW_POST_DATA</faultstring>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

This tell's you there was a request but without data; This is OK
Now if you get the error when calling with your soap client;
remember that your server now will call other functions in the server.php script because it now has some data to process

nodkz at mail dot ru
24-May-2008 03:25

PROBLEM (with SOAP extension under PHP5) of transferring object, that contains objects or array of objects. Nested object would not transfer.

SOLUTION:
This class was developed by trial and error by me. So this 23 lines of code for most developers writing under PHP5 solves fate of using SOAP extension.

<?php
/*
According to specific of organization process of SOAP class in PHP5, we must wrap up complex objects in SoapVar class. Otherwise objects would not be encoded properly and could not be loaded on remote SOAP handler.

Function "getAsSoap" call for encoding object for transmission. After encoding it can be properly transmitted.
*/
abstract class SOAPable {
    public function getAsSOAP() {
        foreach($this as $key=>&$value) {
            $this->prepareSOAPrecursive($this->$key);
        }
        return $this;
    }

    private function prepareSOAPrecursive(&$element) {
        if(is_array($element)) {
            foreach($element as $key=>&$val) {
                $this->prepareSOAPrecursive($val);
            }
            $element=new SoapVar($element,SOAP_ENC_ARRAY);
        }elseif(is_object($element)) {
            if($element instanceof SOAPable) {
                $element->getAsSOAP();
            }
            $element=new SoapVar($element,SOAP_ENC_OBJECT);
        }
    }
}

// ------------------------------------------
//  ABSTRACT EXAMPLE
// ------------------------------------------

class PersonList extends SOAPable {
  protected $ArrayOfPerson; // variable MUST be protected or public!
}

class Person extends SOAPable {
   //any data
}

$client=new SoapClient("test.wsdl", array( 'soap_version'=>SOAP_1_2, 'trace'=>1, 'classmap' => array('Person' => "Person", 'PersonList' => "PersonList")  ));

$PersonList=new PersonList;

// some actions

$PersonList->getAsSOAP();

$client->someMethod($PersonList);

?>

So every class, which will transfer via SOAP, must be extends from class SOAPable. 
As you can see, in code above, function prepareSOAPrecursive search another nested objects in parent object or in arrays, and if does it, tries call function getAsSOAP() for preparation of nested objects, after that simply wrap up via SoapVar class.

So in code before transmitting simply call $obj->getAsSOAP()

add a note

Introduction Web Services

---

Last updated: Fri, 27 Jun 2008