Le constructeur de Zend_Soap_Wsdl prend 3 paramètres:

1. $name - nom du service Web décrit.
2. $uri - URI d'accès au fichier WSDL. (Une référence dans le système de fichier local est possible.)
3. $extractComplexTypes - drapeau optionnel pour spécifier si les types complexes doivent être extraits.

addMessage($name, $parts) ajoute un message de description au document WSDL (/definitions/message de l'élément).

Chaque message correspond à une méthode en terme de fonctionnalité de Zend_Soap_Server et Zend_Soap_Client.

Le paramètre $name représente le nom du message.

Le paramètre $parts est un tableau de paramètre des messages décrivant les paramètres d'appel SOAP. Le tableau est associatif: 'nom du paramètre' (nom du paramètre d'appel SOAP) => 'type du paramètre'.

La correspondance de types est effectuée grâce à addTypes() et addComplexType()(voyez après).

Note: Les paramètres de messages peuvent être soit "element", soit "type" (voyez http://www.w3.org/TR/wsdl#_messages).
"element" doit correspondre à un élément de définition de type. "type" correspond à une entrée complexType.
Tous les types standards XSD possèdent une définition "element" et "complexType" (Voyez http://schemas.xmlsoap.org/soap/encoding/).
Tous les éléments non standards, qui doivent être ajoutés avec la méthode Zend_Soap_Wsdl::addComplexType(), sont décrits en utilisant un noeud "complexType" décrits dans la section "/definitions/types/schema/" du document WSDL.
Ainsi, la méthode addMessage() utilise toujours un attribut "type" pour décrire des types.

addPortType($name) ajoute un nouveau type de portage au document WSDL (/definitions/portType).

Ceci fait la jointure entre des méthodes du service décrites en tant qu'implémentations de Zend_Soap_Server.

Voyez http://www.w3.org/TR/wsdl#_porttypes pour plus de détails.

addPortOperation($portType, $name, $input = false, $output = false, $fault = false) ajoute des définitions de portage au portage défini dans le document WSDL (/definitions/portType/operation).

Chaque opération de portage correspond à une méthode de classe (si le Web Service est basé sur une classe) ou à une fonction (si le Web Service est basé sur des fonctions), ceci en terme d'implémentation de Zend_Soap_Server.

Cette méthode ajoute aussi les messages d'opération correspondants aux portages, ceci dépend des paramètres $input, $output and $fault.

Note: Zend_Soap_Server génère 2 messages pour chaque opération de portage lorsque le service est décrit au travers de la classe Zend_Soap_Server:

• Le message d'entrée nommé $methodName . 'Request'.

• Les message de sortie nommé $methodName . 'Response'.

Voyez http://www.w3.org/TR/wsdl#_request-response pour les détails.

addBinding($name, $portType) ajoute de nouvelles correspondances (bindings) au document WSDL (/definitions/binding).

Le noeud du document WSDL "binding" définit le format du message et les détails du protocole pour les opérations et messages définis par un portage "portType" particulier (voyez http://www.w3.org/TR/wsdl#_bindings).

La méthode crée le noeud de correspondance et le retourne. Il peut alors être utilisé.

L'implémentation de Zend_Soap_Server utilise le nom $serviceName . "Binding" pour la correspondance ("binding") de l'élément du document WSDL.

addBindingOperation($binding, $name, $input = false, $output = false, $fault = false) ajoute une opération à l'élément de correspondance avec le nom spécifié (/definitions/binding/operation).

Cette méthode prend un objet XML_Tree_Node tel que retourné par addBinding(), en paramètre ($binding) pour ajouter un élément "operation" avec des entrées input/output/false dépendantes des paramètres spécifiés.

Zend_Soap_Server ajoute les correspondances pour chaque méthode du Web Service avec des entrées et sorties, définissant l'élément "soap:body" comme <soap:body use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>

Voyez les détails à http://www.w3.org/TR/wsdl#_bindings.

addSoapBinding($binding, $style = 'document', $transport = 'http://schemas.xmlsoap.org/soap/http') ajoute des correspondances (bindings) SOAP ("soap:binding") à l'élément (déjà lié à un portage de type) avec le style et le transport spécifié (Zend_Soap_Server utilise le style RPC sur HTTP).

L'élément "/definitions/binding/soap:binding" est alors utilisé pour spécifier que la correspondance est relative au format du protocole SOAP.

Voyez http://www.w3.org/TR/wsdl#_bindings pour les détails.

addSoapOperation($binding, $soap_action) ajoute une opération SOAP ("soap:operation") à l'élément de correspondance avec l'action spécifiée. L'attribut "style" de l'élément "soap:operation" n'est pas utilisé alors que le modèle de programmation (RPC-oriented ou document-oriented) devrait utiliser la méthode addSoapBinding()

L'attribut "soapAction" de l'élément "/definitions/binding/soap:operation" spécifie la valeur de l'en-tête SOAPAction pour l'opération. Cet attribut est requis pour SOAP sur HTTP et ne doit pas être renseigné pour les autres modes de transports.

Zend_Soap_Server utilise $serviceUri . '#' . $methodName pour le nom de l'action SOAP.

Voyez http://www.w3.org/TR/wsdl#_soap:operation pour plus de détails.

addService($name, $port_name, $binding, $location) ajoute un élément "/definitions/service" au document WSDL avec le nom du Web Service spécifié, le nom du portage, la correspondance, et l'adresse.

WSDL 1.1 autorise d'avoir plusieurs types de portage par service. Cette particularité n'est pas utilisée dans Zend_Soap_Server et est non supportée par la classe Zend_Soap_Wsdl.

Utilisations de Zend_Soap_Server :

• $name . 'Service' comme nom du Web Service,

• $name . 'Port' comme nom de portage des types,

• 'tns:' . $name . 'Binding' ^[1] 'tns:' namespace'http://' .$_SERVER['HTTP_HOST'] . $_SERVER['SCRIPT_NAME'] comme nom de la correspondance,

• l'URI du script^[2] 'http://' .$_SERVER['HTTP_HOST'] . $_SERVER['SCRIPT_NAME'] en tant qu'URI du service pour les Web Service utilisant des classes.

Voyez http://www.w3.org/TR/wsdl#_services pour les détails.

Le WSDL de Zend_Soap utilise les correspondances suivantes pour mapper les type SOAP sur des types PHP:

• chaînes PHP <-> xsd:string.

• entiers PHP <-> xsd:int.

• flottants PHP <-> xsd:float.

• booléens PHP <-> xsd:boolean.

• tableaux PHP <-> soap-enc:Array.

• objets PHP <-> xsd:struct.

• classes PHP <-> tns:$className ^[3] Zend_Soap_Wsdl$extractComplexTypesxsd:anyType tns:$className .

• Type PHP vide <-> void.

• Si le type na aucune correspondance avec les valeurs ci-dessus, alors xsd:anyType est utilisé.

...
$wsdl = new Zend_Soap_Wsdl('My_Web_Service', $myWebServiceUri);

...
$soapIntType = $wsdl->getType('int');

...
class MyClass {
    ...
}
...
$soapMyClassType = $wsdl->getType('MyClass');

addDocumentation($input_node, $documentation) ajoute de la documentation lisible (human readable) grâce à l'élément optionnel "wsdl:document".

L'élément "/definitions/binding/soap:binding" est utilisé pour dire que la correspondance est liée au format du protocole SOAP.

Voyez http://www.w3.org/TR/wsdl#_documentation pour les détails.

toXML(), toDomDocument() et dump($filename = false) peuvent être utilisées pour récupérer un document WSDL sous forme de XML, de structure DOM, ou de fichier.