Die SOAP Eweiterung kann zum Erstellen von SOAP Servern und Clients verwendet werden. Sie unterstützt Untermengen der » SOAP 1.1, » SOAP 1.2 und » WSDL 1.1 Spezifikation.
Die Erweiterung verwendet die » GNOME xml Bibliothek, die heruntergeladen und installiert werden muss. Es wird mind. die Version libxml-2.5.4 vorausgesetzt.
Die Erweiterung ist nur verfügbar, wenn PHP mit der Option --enable-soap konfiguriert wurde.
Das Verhalten dieser Funktionen wird durch Einstellungen in der php.ini beeinflusst.
| Name | Default | Änderbar | Kommentar |
|---|---|---|---|
| soap.wsdl_cache_enabled | "1" | PHP_INI_ALL | Verfügbar seit PHP 5.0.0. |
| soap.wsdl_cache_dir | "/tmp" | PHP_INI_ALL | Verfügbar seit PHP 5.0.0. |
| soap.wsdl_cache_ttl | "86400" | PHP_INI_ALL | Verfügbar seit PHP 5.0.0. |
| soap.wsdl_cache_limit | "5" | PHP_INI_ALL | Verfügbar seit PHP 5.1.4. |
Hier eine kurze Erklärung der Konfigurationsoptionen:
Aktiviert oder deaktiviert das WSDL-Caching.
Systempfad in dem die SOAP-Erweiterung die Cache-Dateien speichern soll.
Dauer in Sekunden (time to live) für die die Cache-Dateien anstelle der originalen verwendet werden sollen.
Maximale Anzahl im Cache zwischengespeicherter WSDL-Dateien
SoapClient->__construct() - Erzeugt ein neues SoapClient-Objekt
SoapClient->__call() - Aufruf einer SOAP-Funktion (deprecated)
SoapClient->__doRequest() - Ausführen einer SOAP-Anfrage
SoapClient->__getFunctions() - Gibt eine Liste der SOAP-Funktionen zurück
SoapClient->__getLastRequest() - Gibt letzte SOAP-Anfrage zurück
SoapClient->__getLastRequestHeaders() - Gibt letzten SOAP-Anfrage-Header zurück
SoapClient->__getLastResponse() - Gibt letzte SOAP-Antwort zurück
SoapClient->__getLastResponseHeaders() - Gibt letzten SOAP-Antwort-Header zurück
SoapClient->__getTypes() - Gibt liste der SOAP-Typen zurück
SoapClient->__setCookie() - Setzt Cookie, der bei SOAP-Anfragen genutzt wird
SoapClient->__soapCall() - Aufruf einer SOAP-Funktion
SoapFault->__construct() - Erzeugen eines neuen SoapFault-Objekts
SoapHeader ist eine spezielle low-level-Klasse zum Austausch von SOAP-Headern. Sie besitzt keine Methoden neben dem Konstruktor und dient als reiner Datenhalter. Sie kann in Verbindung mit der SoapClient->__soapCall()-Methode verwendet werden, um einen SOAP-Header zu übergeben oder um in einem SOAP-Header-Handler den Header in einer SOAP-Antwort zurückzugeben.
SoapHeader->__construct() - Erzeugen eines neuen SoapHeader-Objekts
SoapParam ist eine spezielle low-level-Klasse zum Benennen von Parametern und zum Zurückgeben von Werten im nicht-WSDL-Modus. Sie besitzt keine Methoden neben dem Konstruktor und dient als reiner Datenhalter.
SoapParam->__construct() - Erzeugen eines neuen SoapParam-Objekts
SoapServer->__construct() - Erzeugen eines neuen SoapServer-Objekts
SoapServer->addFunction() - Eine oder mehrere Funktionen hinzufügen, die die SOAP-Anfragen bearbeiten
SoapServer->getFunctions() - Gibt eine Liste der definierten Funktionen zurück
SoapServer->handle() - Behandelt eine SOAP-Anfrage
SoapServer->setClass() - Setzen einer Klasse, die die SOAP-Anfragen bearbeitet
SoapServer->setPersistence() - Setzen des Persistenz-Modus eines SoapServers
SoapVar ist eine spezielle low-level-Klasse zum Kodieren von Parametern und Rückgabewerten im nicht-WSDL-Modus. Sie besitzt keine Methoden neben dem Konstruktor und dient als reiner Datenhalter. Sinnvoll ist der Einsatz wenn Typ-Eigenschaften in SOAP-Anfragen oder -Antworten gesetzt werden muss.
SoapVar->__construct() - Erzeugen eines neuen SoapVar-Objekts
Folgende Konstanten werden von dieser Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde.