Guida al Linguaggio PHP. Lezione 20. Il protocollo SOAP e WSDL Parte 2

Quindi vediamo adesso come implementare un protocollo SOAP con WSDL utilizzando il PHP.

Avremo bisogno dei seguenti requisiti sul nostro PC o Hosting che sia.

• PHP 7+
• zend soap.

Ossia la versione 7 del PHP o superiore e il framework zend soap.

Analizziamo entrambi. Il primo ovviamente è la versione del linguaggio superiore alla 7 , magari in seguito ci torneremo un attimo sopra, ma per il momento non ci occorrono altre spiegazioni. Probabilmente in qualche lezione di approfondimento.

Mentre zend soap altro non è che un potente framework per realizzare web service realizzato appunto dalla società zend . Ovviamente realizzano delle librerie che permettono di costruire con dei semplici passaggi il tutto. Noi in questo caso utilizzeremo le librerie con il composer. Se non sapete come si fa leggete in fondo in appendice, oppure nel sito on line Composer . Quindi procediamo

Installiamo la libreria con il comando

composer require zendframework/zend-soap

A questo punto creiamo un SOAP end point chiamato server.php

<?php

require_once __DIR__ . '/vendor/autoload.php'; //richiamo alle librerie ZEND create con il comando composer.

class Hello
{
 /**
 * Say hello.
 *
 * @param string $firstName
 * @return string $greetings
 */
 public function sayHello($firstName)
 {
 return 'Hello ' . $firstName;
 }

}

$serverUrl = "http://localhost/hello/server.php";
$options = [
 'uri' => $serverUrl,
];
$server = new Zend\Soap\Server(null, $options);

if (isset($_GET['wsdl'])) {
 $soapAutoDiscover = new \Zend\Soap\AutoDiscover(new \Zend\Soap\Wsdl\ComplexTypeStrategy\ArrayOfTypeSequence());
 $soapAutoDiscover->setBindingStyle(array('style' => 'document'));
 $soapAutoDiscover->setOperationBodyStyle(array('use' => 'literal'));
 $soapAutoDiscover->setClass('Hello');
 $soapAutoDiscover->setUri($serverUrl);

header("Content-Type: text/xml");
 echo $soapAutoDiscover->generate()->toXml();
} else {
 $soap = new \Zend\Soap\Server($serverUrl . '?wsdl');
 $soap->setObject(new \Zend\Soap\Server\DocumentLiteralWrapper(new Hello()));
 $soap->handle();
}

Questo file non crea solamente il protocollo SOAP ma anche il linguaggio WSDL che descrive il servizio. Chiunque voglia sapere che cosa fa il vostro webservice potrà controllare il relativo file wsdl presso

http://localhost/hello/server.php?wsdl

A questo punto dobbiamo creare il client. Per semplicità il tutto verrà tenuto nello stesso computer. In un caso reale il server.php si trova nel web server in remoto , mentre il client.php è nel nostro computer utente che interroga il server in remoto e per sapere cosa fa il server in remoto si legge il file wsdl di cui sopra. Quindi avremo.

<?php

require_once __DIR__ . '/vendor/autoload.php';

$client = new Zend\Soap\Client('http://localhost/hello/server.php?wsdl');
$result = $client->sayHello(['firstName' => 'World']);

echo $result->sayHelloResult;

E la risposta che otterremo è la seguente

Hello World

E’ possibile che otteniate un fatal error. Dipende da una possibile incompatibilità fra la libreria di Zend Framework e PHP 7. Probabilmente al momento in cui state leggendo già risolta. Per ogni buon conto sostituite

$result = $client->sayHello(['firstName' => 'World']);

con

$result = $client->call('sayHello', [['firstName' => 'World']]);

Ovviamente questo non è un esempio esaustivo ma credo che renda molto bene l’idea di come funziona il tutto.