SOAP

• Introduction
• Installation/Configuration
  • Installation
  • Configuration à l'exécution
  • Types de ressources
• Constantes pré-définies
• Fonctions SOAP
  • is_soap_fault — Vérifie si l'API soap a échoué
  • SoapClient->__call() — Appelle une fonction SOAP (dépréciée)
  • SoapClient->__construct() — Constructeur SoapClient
  • SoapClient->__doRequest() — Effectue une requête SOAP
  • SoapClient->__getFunctions() — Retourne une liste de fonctions SOAP
  • SoapClient->__getLastRequest() — Retourne la dernière requête SOAP
  • SoapClient->__getLastRequestHeaders() — Retourne les en-têtes de la dernière requête SOAP
  • SoapClient->__getLastResponse() — Retourne la dernière réponse SOAP
  • SoapClient->__getLastResponseHeaders() — Retourne les en-têtes de la dernière réponse SOAP
  • SoapClient->__getTypes() — Retourne une liste des types SOAP
  • SoapClient->__setCookie() — Définit le cookie qui sera envoyé avec la requête SOAP
  • SoapClient->__soapCall() — Appel une fonction SOAP
  • SoapFault->__construct() — Constructeur SoapFault
  • SoapHeader->__construct() — Constructeur SoapHeader
  • SoapParam->__construct() — Constructeur SoapParam
  • SoapServer->addFunction() — Ajoute une ou plusieurs fonctions qui vont gérer les requêtes SOAP
  • SoapServer->__construct() — Constructeur SoapServer
  • SoapServer->fault() — Provoque une erreur SoapServer indiquant une erreur
  • SoapServer->getFunctions() — Retourne la liste des fonctions définies
  • SoapServer->handle() — Gère une requête SOAP
  • SoapServer->setClass() — Définit la classe qui gère les requêtes SOAP
  • SoapServer->setPersistence() — Définit le mode persistant de SoapServer
  • SoapVar->__construct() — Constructeur SoapVar
  • use_soap_error_handler — Utilisation ou non du gestionnaire d'erreurs SOAP et retourne l'ancienne valeur

add a note User Contributed Notes
SOAP

aeg at mallxs dot nl
28-May-2008 02: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 11: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 Services Web

---

Last updated: Fri, 20 Jun 2008