SoapClient::__construct
(PHP 5, PHP 7, PHP 8)
SoapClient::__construct — SoapClient-Konstruktor
Beschreibung
$wsdl
, array $options = []
)
Dieser Konstruktor erstellt SoapClient-Objekte im
WSDL- oder non-WSDL-Modus.
Parameter-Liste
-
wsdl -
Die URI der
WSDL-Datei odernull, wenn dernon-WSDL-Modus verwendet wird.Hinweis:
Während der Entwicklung sollte das WSDL-Caching durch die Verwendung der
soap.wsdl_cache_ttl-Option in der php.ini ausgeschaltet werden. Andernfalls wirken sich Änderungen an der WSDL-Datei erst aus, wennsoap.wsdl_cache_ttlabgelaufen ist. -
options -
Ein Array mit Optionen. Wenn im WSDL-Modus gearbeitet wird, ist dieser Parameter optional. Im non-WSDL-Modus müssen die Optionen
locationundurigesetzt werden. Dabei enthältlocationdie URL des SOAP-Servers, an den die Anfrage gesendet werden soll, unduriden Ziel-Namensraum des SOAP-Dienstes.Die Optionen
styleundusefunktionieren nur im non-WSDL-Modus. Im WSDL-Modus werden sie durch das WSDL-File bestimmt.Die Option
soap_versionsollte entwederSOAP_1_1oderSOAP_1_2sein, um SOAP 1.1 bzw. 1.2 auszuwählen. Wird sie weggelassen, wird 1.1 verwendet.Für die HTTP-Authentifizierung können die Optionen
loginundpasswordverwendet werden, um Anmeldeinformationen anzugeben. Um eine HTTP-Verbindung über einen Proxy-Server herzustellen, stehen auch die Optionenproxy_host,proxy_port,proxy_loginundproxy_passwordzur Verfügung. Für die Authentifizierung mit HTTPS-Client-Zertifikaten sind die Optionenlocal_certundpassphrasezu verwenden. Eine Authentifizierung kann mit der Optionauthenticationangegeben werden. Die Authentifizierungsmethode kann entwederSOAP_AUTHENTICATION_BASIC(Standard) oderSOAP_AUTHENTICATION_DIGESTsein.Die Option
compressionermöglicht die Komprimierung von HTTP-SOAP-Anfragen und -Antworten.Die Option
encodingdefiniert die interne Zeichenkodierung. Diese Option ändert nicht die Kodierung von SOAP-Anfragen (sie ist immer utf-8), sondern wandelt Zeichenketten in diese Kodierung um.Die Option
traceaktiviert die Aufzeichnung von Anfragen, damit Fehler zurückverfolgt werden können. Die Voreinstellung istfalse.Die Option
classmapkann verwendet werden, um einige WSDL-Typen auf PHP-Klassen abzubilden. Diese Option muss ein Array mit WSDL-Typen als Schlüssel und Namen von PHP-Klassen als Werte sein.Das Setzen der booleschen Option
traceermöglicht die Verwendung der Methoden SoapClient->__getLastRequest, SoapClient->__getLastRequestHeaders, SoapClient->__getLastResponse und SoapClient->__getLastResponseHeaders.Die Option
exceptionsist ein boolescher Wert, der festlegt, ob Soap-Fehler Exceptions vom Typ SoapFault auslösen.Die Option
connection_timeoutdefiniert einen Timeout in Sekunden für die Verbindung zum SOAP-Dienst. Diese Option definiert keinen Timeout für Dienste mit langsamen Antworten. Um die Zeit zu begrenzen, die auf die Beendigung von Aufrufen gewartet wird, steht die Einstellung default_socket_timeout zur Verfügung.Die Option
typemapist ein Array mit Typzuordnungen. Die Typzuordnung ist ein Array mit den Schlüsselntype_name,type_ns(Namensraum-URI),from_xml(ein Callback, der einen Zeichenketten-Parameter akzeptiert) undto_xml(ein Callback, der einen Objekt-Parameter akzeptiert).Die Option
cache_wsdlist entwederWSDL_CACHE_NONE,WSDL_CACHE_DISK,WSDL_CACHE_MEMORYoderWSDL_CACHE_BOTH.Die Option
user_agentgibt die Zeichenkette an, die imUser-Agent-Header verwendet werden soll.Die Option
stream_contextist eine resource für den context.Die Option
featuresist eine Bit-Maske ausSOAP_SINGLE_ELEMENT_ARRAYS,SOAP_USE_XSI_ARRAY_TYPEundSOAP_WAIT_ONE_WAY_CALLS.Die Option
keep_aliveist ein boolescher Wert, der festlegt, ob derConnection: Keep-Alive-Header oderConnection: closegesendet wird.Die Option
ssl_methodist eine der KonstantenSOAP_SSL_METHOD_TLS,SOAP_SSL_METHOD_SSLv2,SOAP_SSL_METHOD_SSLv3undSOAP_SSL_METHOD_SSLv23.
Fehler/Exceptions
Wenn die Optionen location und uri
im non-WSDL-Modus nicht angegeben werden, erzeugt
SoapClient::__construct() einen
E_ERROR-Fehler.
Wenn die wsdl-URI nicht geladen werden kann, wird
eine SoapFault-Exception ausgelöst.
Beispiele
Beispiel #1 SoapClient::__construct()-Beispiel
<?php
$client = new SoapClient("ein.wsdl");
$client = new SoapClient("ein.wsdl", array('soap_version' => SOAP_1_2));
$client = new SoapClient("ein.wsdl", array('login' => "ein_name",
'password' => "ein_passwort"));
$client = new SoapClient("ein.wsdl", array('proxy_host' => "localhost",
'proxy_port' => 8080));
$client = new SoapClient("ein.wsdl", array('proxy_host' => "localhost",
'proxy_port' => 8080,
'proxy_login' => "ein_name",
'proxy_password' => "ein_passwort"));
$client = new SoapClient("ein.wsdl", array('local_cert' => "cert_key.pem"));
$client = new SoapClient(null, array('location' => "http://localhost/soap.php",
'uri' => "http://test-uri/"));
$client = new SoapClient(null, array('location' => "http://localhost/soap.php",
'uri' => "http://test-uri/",
'style' => SOAP_DOCUMENT,
'use' => SOAP_LITERAL));
$client = new SoapClient("ein.wsdl",
array('compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP));
$client = new SoapClient("ein.wsdl", array('encoding'=>'ISO-8859-1'));
class MeinBuch {
public $titel;
public $autor;
}
$client = new SoapClient("buecher.wsdl", array('classmap' => array('buch' => "MeinBuch")));
?>
add a note
