PHP: SOAP – Web Service Client schreiben
Gepostet von Alexander Gräsel in PHP, Programmierung, Web Service am 28 Mai, 2012 | 11 Kommentare
Am 10. Oktober 2011 habe ich behauptet, dass wirklich JEDER Java-Entwickler einen Web Service innerhalb von 15 Sekunden schreiben kann. Diese Behauptung konnte bisher keiner wiederlegen:-)
Darum behaupte ich heute, dass wirklich JEDER PHP-Entwickler einen Web Service Client in nur 10 Sekunden schreiben kann. Man brauch lediglich einen Web Service (WSDL + Endpoint) und einen php-fähigen Server (z.B. Apache). Lasst uns los legen und keine Zeit verlieren!
Das Environment
Die Grundvoraussetzung, um einen Web Service rufen zu können, ist die Erreichbarkeit des Entpoints/der WSDL. Diese können Sie ganz einfach testen, indem Sie die WSDL-URL im Browser eingeben. Bei meinem Beispiel sieht das Ergebnis so aus:
Zuvor habe ich das Beispiel „RechteckWS-Server“ heruntergeladen, das Projekt in Eclipse importiert und die Server-Klasse ausgeführt…
Das PHP-Script
Die Zauberklasse in PHP heißt soapclient. MERKE: Der Name der Methode und der Attribute sind in der WSDL fest definiert!
<?php
// WSDL-URL_Adresse
// Kann lokal liegen oder per Endpoint (wie in diesem Beispiel) bezogen werden
$client = new SoapClient("http://localhost:9202/rechteck/RechteckWebService?wsdl");
// Änderung des Web Service Endpoints
$client->__setLocation('http://localhost:9202/rechteck/RechteckWebService');
// Web Service Call
// Methoden Name 1. Parameter 2. Parameter
$result = $client->__soapCall("berechneUmfang", array('Laenge' => 10, 'Breite' => 20));
// oder
$result = $client->berechneUmfang(array('Laenge' => 10, 'Breite' => 20));
// Zugriff auf das Ergebnis
print $result->Umfang;
?>
…FERTIG!
HTML5 + PHP-Script
Das Ergebnis kann man auch in eine kleine Demo-Webseite verpacken. Auchtung die Webseite lag lokal auf einer XAMPP Installation! Die WSDL muss von dem entsprechenden Server erreichbar sein.
<!DOCTYPE html>
<html>
<head>
<title>HTML5 RechteckWS Seite</title>
</head>
<body>
<header>
<h1>hallo Rechteck WS</h1>
</header>
<section>
<article>
<h1>WS Call</h1>
<p>
<?php
// WSDL-URL_Adresse
// Kann lokal liegen oder per Endpoint (wie in diesem Beispiel) bezogen werden
$client = new SoapClient("http://localhost:9202/rechteck/RechteckWebService?wsdl");
// Änderung des Web Service Endpoints
$client->__setLocation('http://localhost:9202/rechteck/RechteckWebService');
// Web Service Call
// Methoden Name 1. Parameter 2. Parameter
$result = $client->__soapCall("berechneUmfang", array('Laenge' => 10, 'Breite' => 20));
// oder
$result = $client->berechneUmfang(array('Laenge' => 10, 'Breite' => 20));
// druckt das Ergebnis
var_dump ($result);
print '<br />';
// Zugriff auf das Ergebnis
print $result->Umfang;
print '<br />';
?>
</p>
</article>
</section>
<footer>
<h1>AxxG</h1>
</footer>
</body>
</html>
Der Konstruktor der soapclient-Klasse
Im Normalfall reicht es, die WSDL-URL-Adresse im Konstruktor der soapclient-Klasse anzugeben. Jedoch lehrt uns die Wirklichkeit, dass es sehr viele Spezialfälle gibt:
<?php
// Standard
$client = new SoapClient("ein.wsdl");
// Standard + SOAP Version
$client = new SoapClient("ein.wsdl", array('soap_version' => SOAP_1_2));
// Standard + HTTP Authentifizierung
$client = new SoapClient("ein.wsdl", array('login' => "ein_name",
'password' => "ein_passwort"));
// Standard + Proxy
$client = new SoapClient("ein.wsdl", array('proxy_host' => "localhost",
'proxy_port' => 8080));
// Standard + Proxy mit Verschluesselung
$client = new SoapClient("ein.wsdl", array('proxy_host' => "localhost",
'proxy_port' => 8080,
'proxy_login' => "ein_name",
'proxy_password' => "ein_passwort"));
// Standard + WSDL und Endpoint-Trennung
$client = new SoapClient(null, array('location' => "http://localhost/soap.php",
'uri' => "http://test-uri/"));
// Standard + WSDL und Endpoint-Trennung + SOAP Spec
$client = new SoapClient(null, array('location' => "http://localhost/soap.php",
'uri' => "http://test-uri/",
'style' => SOAP_DOCUMENT,
'use' => SOAP_LITERAL));
// Standard + Encoding
$server = new SoapClient("ein.wsdl", array('encoding'=>'ISO-8859-1'));
?>
Quellen und Links
- Lokaler PHP-Server (Xampp Apache)
- Die soapclient-PHP-Klasse (php.net)
- detaillierte Informationen und weitere Beispiele (html-world.de)
Copyright © 2012 AxxG – Alexander Gräsel
Verwandte Beiträge
11 Antworten : “PHP: SOAP – Web Service Client schreiben”
Trackbacks/Pingbacks
- KW7: Amazon-Bericht, Push-Notifications, PHP-Webservice-Client und mehr | Der Softwareentwickler Blog - [...] Hier geht es zu diesem PHP-Tutorial. [...]
- Motivation für verteilte Systeme | trollheaven - […] https://blog.axxg.de/php-soap-web-service-client/ gibt es ein einführendes Beispiel. Gezeigt wird wie über SOAP, PHP und […]
Kommentar verfassen
Über mich
Willkommen, Welcome, Velkommen, Bienvenue, Benvenuti, Bienvenido! Mein Name ist Alexander Gräsel und ich bin Masterstudent der Fachrichtung Wirtschaftsinformatik. Ich schreibe diesen Blog um einerseits mein Wissen zu dokumentieren und anderseits das Unwissen der Menschheit etwas zu minimieren. Primär beschäftige ich mich mit der Softwareentwicklung in Java, Java EE und C/C++. Zusätzlich befasse ich mich mit (Web)Desgin, Joomla, Wordpress und natürlich Flash/Actionscript 3:-) Folgen
Initiative
Ein weiteres tolles Thema ist Web Service Security (WSS) oder WS-Security.
Einen sehr schönen Artikel darüber findet ihr hier! (Stackoverflow)
Normalerweise habe ich ja keinen Zugriff auf die Serverklassen. Meine einzige Informationsquelle ist das WSDL. Den Funktionsaufruf „berechneUmfang“ kann ich aus dem WSDL entnehmen. Aber woher weiß ich dann eigentlich, dass die erforderlichen Variablen Laenge und Breite heißen?
Hallo,
die Signatur der Methode befindet sich auch in der WSDL. Jedoch gibt es diverse Möglichkeiten die WSDL zu zerlegen. Zum Beispiel: In eine Schema.xml
Der Verweis auf ggf. externen Dateien befindet sich immer in der WSDL. (Siehe Zeile 6)
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <!-- Generated by JAX-WS RI at . RI's version is JAX-WS RI 2.1.6 in JDK 6. --> <definitions targetNamespace="http://www.axxg.de/ws/rechteck" name="RechteckWebService" xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="http://www.axxg.de/ws/rechteck" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"> <types> <xsd:schema> <xsd:import namespace="http://www.axxg.de/ws/rechteck" schemaLocation="RechteckWebService_schema1.xsd"/> </xsd:schema> </types> <message name="berechneUmfang"> <part name="parameters" element="tns:berechneUmfang"/> </message> <message name="berechneUmfangResponse"> <part name="parameters" element="tns:berechneUmfangResponse"/> </message> <message name="berechneInhalt"> <part name="parameters" element="tns:berechneInhalt"/> </message> <message name="berechneInhaltResponse"> <part name="parameters" element="tns:berechneInhaltResponse"/> </message> <portType name="RechteckWebService"> <operation name="berechneUmfang"> <input message="tns:berechneUmfang"/> <output message="tns:berechneUmfangResponse"/> </operation> <operation name="berechneInhalt"> <input message="tns:berechneInhalt"/> <output message="tns:berechneInhaltResponse"/> </operation> </portType> <binding name="RechteckWebServicePortBinding" type="tns:RechteckWebService"> <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/> <operation name="berechneUmfang"> <soap:operation soapAction=""/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> </operation> <operation name="berechneInhalt"> <soap:operation soapAction=""/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> </operation> </binding> <service name="RechteckWebService"> <port name="RechteckWebServicePort" binding="tns:RechteckWebServicePortBinding"> <soap:address location="REPLACE_WITH_ACTUAL_URL"/> </port> </service> </definitions>Die Schema.xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <xs:schema version="1.0" targetNamespace="http://www.axxg.de/ws/rechteck" xmlns:tns="http://www.axxg.de/ws/rechteck" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:element name="berechneInhalt" type="tns:berechneInhalt"/> <xs:element name="berechneInhaltResponse" type="tns:berechneInhaltResponse"/> <xs:element name="berechneUmfang" type="tns:berechneUmfang"/> <xs:element name="berechneUmfangResponse" type="tns:berechneUmfangResponse"/> <xs:complexType name="berechneInhalt"> <xs:sequence> <xs:element name="Laenge" type="xs:float"/> <xs:element name="Breite" type="xs:float"/> </xs:sequence> </xs:complexType> <xs:complexType name="berechneInhaltResponse"> <xs:sequence> <xs:element name="Flaecheninhalt" type="xs:float"/> </xs:sequence> </xs:complexType> <xs:complexType name="berechneUmfang"> <xs:sequence> <xs:element name="Laenge" type="xs:float"/> <xs:element name="Breite" type="xs:float"/> </xs:sequence> </xs:complexType> <xs:complexType name="berechneUmfangResponse"> <xs:sequence> <xs:element name="Umfang" type="xs:float"/> </xs:sequence> </xs:complexType> </xs:schema>Das Code-Plugin kann bei mir den Code nicht richtig darstellen. die <-Zeichen werden bei mir encodiert dargestellt.
Das ist so gewollt^^ (Schutz vor XSS)
Da ich gerade dieAnbindung einer Mobile App an ein Webservice plane, kommt mir der Artikel wie gerufen. Danke dafür!
schön, dass ich dir weiterhelfen konnte!
Ich bin schon sehr auf deine Mobile App gespannt:-)
Hallo,
ich möchte Dir natürlich nicht zu nahe treten aber sowohl Deine erste als auch Deine zweite Behauptung sind vollkommener nonsens. Wenn mir jemand einen Webservice anbietet, den er in wenigen Minuten zusammengeschustert hat, dann möchte ich den wirklich nicht sehen. In dieser Zeit kann sicherlich irgendwas ohne Sinn und Verstand kopiert werden und genau deshalb weiß ich auch gar nicht, wozu dieser Artikel überhaupt gut sein soll außer zur Google-Content-Mehrung.
Eine WSDL schreibt man wirklich nicht selbst sondern läßt sie generieren. Was um Himmels Willen soll Deine WSDL für einen Nutzen haben?
Entweder habe ich den Ergeiz einen guten Artikel zu schreiben (das geht auch nicht in ein paar Minuten) und mache mir dann wenigstens die Mühe zu erklären, was ich da überhaupt veranstalte. Du (sorry) rotzt einfach irgendeinen Kram in die Welt und überläßt dann großzügig dem Leser die Suche nach der eigentlichen Funktionsweise.
Mir geht es echt langsam auf den Keks, dass immer mehr Leute meinen, sie müssen auf Gedeih und Verderb die Zeit anderer Leute verplempern.
Erst mal danke ich dir für dein Feedback. Jede Kritik, egal ob positiv oder negativ, bringt mich weiter.
@Zielgruppe
Mein Beitrag richtet sich in erster Linie an Entwickler, die ein entsprechendes Basiswissen (PHP, Web Service, XML) mitbringen. Ich fange selten bei Null an und fokussiere mich eher auf einfache/verständliche Beispiele.
@Qualität
Wie du schon gemerkt hast, kann man es nicht Allen recht machen. Dem Einen ist es zu viel Text, Theorie, Bilder und co – dem Anderen ist es zu wenig. Jedoch nötige ich niemanden meinen Blog zu lesen! Andere Seiten (zu finden unter der Überschrift „Quellen und Links“) beschreiben den gleichen Sachverhalt. Z.B.:http://www.html-world.de/program/phpex_9.php
Des Weiten gibt es noch Suchmaschinen, Foren und co.
@Empfehlung
Ich empfehle dir die Seiten http://www.blogger.com oder http://de.wordpress.com/. Auf diesen Seiten kann man sich kostenlos einen Blog anlegen.
Kann euch beiden zustimmen in einigen Punkten zustimmen.
@Jürgen
Sicherlich ist es für eine gewissen Benutzergruppe schwierig solch ein umfassendes Thema ohne genügend Basis-Wissen zuverstehen. Ich als Gelegenheits-Blogger mag es auch lieber komplett erklärt, so dass keine Rückfragen notwendig sind. In diesem Punkt gebe ich dir recht.
Es gibt aber eben auch Menschen, die suchen für ihre Problemlösung ein gut aufbearbeiteten Beitrag zu einem bestimmen Thema, welches Anhaltspunkte für genau ihr Problem bietet, ohne dabei zu weit auszuholen. Von daher sollte man als Leser sich bewusst sein, dass es für einen Blogger nicht möglich ist – auch wenn es eine einfache Überschrift so suggeriert – genau den Content zu liefern den man sich vorstellt.
Und dafür gibt es eben nicht nur einen Blog der über Thema XY schreibt sondern x belibige mit unterschiedlichen Stilen und Motivationen. Aus diesem Grund gebe ich Alex recht in seinem Kommentar recht und finde es aber dennoch gut, dass du diesen Kommetar postest, da es ja auch dein gutes Recht ist deine Meinung hier zu äußern. Jedoch würde ihr dir nahelegen, beim nächsten Mal die hier diskutierten Sachverhalte zu berücksichtigen.
Was man diesem Blog hier zu gute halten muss, ist das der Alex im dem Grundgedanken des Internets nachkommt und fleißig auch seine Quellen und weiterführende Links mitangibt, so dass ein interessierter Leser einen aufgezeigten Weg bekomtm, wo er nach weiteren (ihm fehlende) Informationen suchen kann.
Zum Abschluss: noch ein Zitat aus einem bekannten Blog:
„Womit wir beim bloggen wären. Ich finde, es sollten noch viel mehr machen. Also bloggen. Man liest ja immer, dass Blogs tot sind. So ein Bullshit. Blogs werden immer mehr. Jeder ist ein eigener Sender. Der eine macht Food, der andere Autos, der andere Schminke oder Mode. Ich mache halt Technik-Gedöns. Aber wichtig ist: macht es! Ich will euch lesen! Unabhängige Stimmen, die mir von ihren Erfahrungen in 1000 Kategorien des Lebens erzählen!“ [Caschy, 4. März 2013, http://stadt-bremerhaven.de/ich-blogge-jetzt-8-jahre-und-wollte-euch-was-sagen/%5D
Danke!!