Zend Framework 1.7.9 Manual
|
|
Die SOAP Funktionalität die im Zend Framework implementiert ist, ist dazu gedacht alle benötigten Schritte für die SOAP Kommunikation einfacher zu gestalten.
SOAP ist ein von der Sprache unabhängiges Protokoll. Deshalb kann es nicht nur für PHP-zu-PHP Kommunikation verwendet werden.
Es gibt drei Konfigurationen für SOAP Anwendungen wo Zend Framework verwendet werden kann:
Wir müssen immer wissen, welche Funktionalität vom SOAP Server angeboten wird um mit Ihm zu arbeiten. » WSDL wird verwendet um die Netzwerk Service API im Detail zu beschreiben.
Die WSDL Sprache ist komplex genug (siehe » http://www.w3.org/TR/wsdl für die Details). Es ist also kompliziert genug die richtige WSDL Beschreibung vorzubereiten.
Ein anderes Problem ist die Synchronisation von Änderungen in der Netzwerk Service API mit schon existierendem WSDL.
Aber dieses Problem kann durch WSDL Autogeneration gelöst werden. Eine Vorbedingung dafür ist ein SOAP Server Autodiscovery. Es erzeugt ein Objekt ähnlich dem Objekt das in der SOAP Server Anwendung verwendet wird, extrahiert notwendige Informationen und erzeugt ein korrektes WSDL indem es die Information verwendet.
Es gibt zwei Wege für die Verwendung des Zend Framworks für SOAP Server Anwendungen:
Verwendung von eigenen Klassen.
Verwendung eines Sets von Funktionen
Beide Methoden werden von der Zend Framework Autodiscovery Funktionalität unterstützt.
Die Zend_Soap_AutoDiscovery Klasse unterstützt auch das Mapping von Datentypen von PHP zu » XSD Typen.
Hier ist ein Beispiel einer üblichen Verwendung der Autodiscovery Funktionalität:
class My_SoapServer_Class {
...
}
$autodiscover = new Zend_Soap_AutoDiscover();
$autodiscover->setClass('My_SoapServer_Class');
$autodiscover->handle();
Wenn eine Klasse verwendet wird um SOAP Server Funktionalitäten anzubieten, dann sollte die selbe
Klasse an Zend_Soap_AutoDiscovery für die WSDL Erzeugung übergeben werden:
$autodiscover = new Zend_Soap_AutoDiscover();
$autodiscover->setClass('My_SoapServer_Class');
$autodiscover->handle();
Die folgenden Regeln werden wärend der WSDL Erzeugung verwendet:
Erzeugtes WSDL beschreibt einen RPC srtigen Web Service.
Klassen Namen werden als Name des Web Services verwendet der beschrieben wird.
'http://' .$_SERVER['HTTP_HOST'] . $_SERVER['SCRIPT_NAME'] wird als URI
verwendet so das WSDL vorhanden ist.
Es wird auch als Ziel Namespace für alle Service bezogenen Namen verwendet (inklusive der beschriebenen komplexen Typen).
Klassen Methoden werden in einen » Port Typ übernommen.
$className . 'Port' wird als Port Typ Name verwendet.
Jede Klassen Methode wird als korrespondierende Port Operation registriert.
Jeder Methoden Prototyp erzeugt korrespondierende Anfrage/Antwort Nachrichten.
Eine Methode kann verschiedene Prototypen haben wenn einige Parameter der Methode optional sind.
Note: Wichtig!
WSDL Autodiscovery verwendet PHP Docblocks die vom Entwickler angeboten werden um die Parameter und Return Typen zu erkennen. Faktisch ist das, für skalare Typen, der einzige Weg um die Parameter Typen zu erkennen und für Return Typen ist das der einzige Weg um Sie zu erkennen.
Das bedeutet, das Anbieten von richtigen und komplett detailierten Docblocks ist nicht nur beste Praxis, sondern wird für das erkunden der Klasse benötigt.
Wenn ein Set von Funktionen verwendet wird um SOAP Server Funktionalität anzubieten, dann sollte
das selbe Set mit Zend_Soap_AutoDiscovery für die WSDL Erzeugung verwendet werden:
$autodiscover = new Zend_Soap_AutoDiscover();
$autodiscover->addFunction('function1');
$autodiscover->addFunction('function2');
$autodiscover->addFunction('function3');
...
$autodiscover->handle();
Die folgenden Regeln werden wärend der WSDL Erzeugung verwendet:
Ein erstelltes WSDL beschreibt einen RPC artigen Web Service.
Der aktuelle Skriptname wird als Name des Web Services verwendet der beschrieben wird.
'http://' .$_SERVER['HTTP_HOST'] . $_SERVER['SCRIPT_NAME'] wird als URI
verwendet wo WSDL vorhanden ist.
Wird als Ziel Namespace für alle Service bezogenen Namen verwendet (inklusive der beschriebenen komplexen Typen).
Funktionen werden in einem » Port Typ verbunden.
$functionName . 'Port' wird als Port Typ Name verwendet.
Jede Funktion wird als korrespondierende Port Operation registriert.
Jeder Funktions Prototyp erzeugt eine korrespondierende Anfrage/Antwort Nachricht.
Funktionen können verschiedene Prototypen haben wenn einige Parameter der Methode optional sind.
Note: Wichtig!
WSDL Autodiscovery verwendet PHP Docblocks die vom Entwickler angeboten werden um die Parameter und Return Typen zu erkennen. Faktisch ist das, für skalare Typen, der einzige Weg um die Parameter Typen zu erkennen und für Return Typen ist das der einzige Weg um Sie zu erkennen.
Das bedeutet, das Anbieten von richtigen und komplett detailierten Docblocks ist nicht nur beste Praxis, sondern wird für das erkunden der Klasse benötigt.
Eingabe/Ausgabe Datentypen werden in Netzwerk Service Typen konvertiert indem das folgende Mapping verwendet wird:
PHP Strings <-> xsd:string.
PHP Integer <-> xsd:int.
PHP Float und Double <-> xsd:float.
PHP Boolean <-> xsd:boolean.
PHP Arrays <-> soap-enc:Array.
PHP Objekt <-> xsd:struct.
PHP Klasse <-> basierend auf der Strategie der komplexen Typen (See: Hinzufügen komplexer Typ Informationen.)
[1]
Zend_Soap_AutoDiscoverZend_Soap_Wsdl_Strategy_DefaultComplexTypeZend_Soap_Wsdl_Strategy_Interface$extractComplexTypeZend_Soap_Wsdl Manual
über das Hinzufügen von komplexen
.
type[] oder object[] (z.B. int[]) <-> basieren auf der Strategie der komplexen Typen
PHP Void <-> Leerer Typ.
Wenn der Typ aus irgendeinem Grund keinem dieser Typen entspricht, dann wird
xsd:anyType verwendet.
xsd: ein "http://www.w3.org/2001/XMLSchema" Namespace ist, ist
soap-enc: ein "http://schemas.xmlsoap.org/soap/encoding/" Namespace, und
tns: ist ein "Ziel Namespace" für einen Service.
|
|
|