Web Services avec PHP5 : SOA

Un Service WEB est un ensemble de protocoles permettant à des applications de communiquer entre elles, et ce indépendamment de la structure et du langage employés.

• Le couplage fort (c'est en général les types d'interactions natives, par exemple une interface graphique couplée aux contrôleurs dans une architecture MVC) ;
• Le couplage faible, dans lequel interviennent les Services WEB (En général, il s'agit de la communication entre 2 composants physiquement séparés). Dans le cas d'un couplage faible, on parlera aussi d' « Architecture Orientée Service » (SOA), qui permet de rendre des composants applicatifs disponibles via un service, la plupart du temps un ou des Services WEB. (On nommera par exemple l'ensemble de Services WEB Google, qui est typiquement un SOA).

Les Services WEB sont un avantage certain notamment pour diversifier la façon de servir des données : en effet, on peut très bien imaginer une application présentant une interface graphique formatée et, par l'intermédiaire de Services WEB, permettre l'interfaçage avec d'autres types de médias.

• Le protocole RPC (Remote Procedure Call), ancêtre de SOAP et qui a donné lieu à XML-RPC et JSON-RPC : il permet à des processus issus d'environnements hétérogènes de faire appel à des procédures distantes via un protocole de communication (HTTP, SMTP...),
• REST (Representational State Transfert), qui n'est pas un protocole au même titre que RPC, mais une architecture définie par des règles « simples » facilitant l'accès à ces services et basé sur HTTP.
• SOAP, ou Simple Object Access Protocol, qui autorise des objets à faire des appels à des méthodes issues d'autres objets la plupart du temps physiquement séparés (serveurs distants). SOAP utilise le plus souvent HTTP comme protocole de communication, mais il peut aussi utiliser d'autres protocoles comme SMTP.

Nous utiliserons SOAP comme base dans le reste de l'article, car l'un des plus répandus pour réaliser des Services WEB, et géré en natif par PHP 5.

REST est aussi beaucoup utilisé, et représente une approche des Services WEB moins « stricte » que SOAP car il repose entièrement et uniquement sur HTTP. Les Services WEB d'Amazon par exemple sont en REST.

SOAP est un protocole RPC (Remote Procedure Call) orienté objet permettant de communiquer et d'échanger des messages.

Ainsi, il permet la communication et la transmission de messages entre 2 objets distants, autorisant l'appel à des méthodes servies par un Service WEB.

1. L'enveloppe, qui contient toutes les informations relatives au contenu du message ;
2. Le contenu lui-même qui est formé de données structurées (méthodes formatées, interrogation structurée d'après les besoins du serveur, etc.).

Un message SOAP repose sur les technologies XML, ce qui permet une interopérabilité totale entre systèmes (cf. les tutoriels XMLCours et tutoriels XML). XML décrit les bases de SOAP, cœur du Service WEB. À noter que SOAP peut communiquer sur différents protocoles de communication, tels HTTP ou SMTP (ce qui représente un avantage : le port 80 des firewalls est souvent ouvert, ce qui permet de ne pas modifier les règles de sécurité dans une entreprise). Par ailleurs, SOAP est régi par des normes du W3C.

Nous avons un protocole d'échange entre 2 objets distants, nous avons un serveur de Service WEB et nous voulons consommer... Mais comment savoir ce que l'on peut consommer, et de quelle manière ? La description WSDL répond à cette question.

WSDL signifie Web Services Description Language et doit être fourni par le fournisseur du Service WEB (le serveur). Il est possible de s'en passer, mais alors la fourniture du Service WEB risque d'être difficile, ne sachant pas ce que l'on peut faire avec !!!

Le fichier WSDL est en XML et il permet de décrire l'utilisation complète du service. C'est en fait un mode d'emploi, ni plus ni moins, et il permettra à de nombreux programmes ou même langages de programmation de découvrir automatiquement un service, voire de gérer les modalités d'échanges SOAP (port d'échange, protocole, encodage, etc.), on pourrait presque le comparer à la DTD d'un fichier XML (Zend Studio et DIA permettent la réalisation assistéee d'un tel fichier, sinon on peut se servir des spécifications W3C pour l'écrire à la main).

PHP5 intègre d'origine une API SOAP permettant de créer des serveurs ou des clients, et ce de façon très simplifiée.

En effet, PHP5 interprète de façon transparente les fichiers WSDL lors de la déclaration d'un client à un Service WEB, et gère lui-même le formatage SOAP des messages envoyés au serveur : formatage XML, respect des règles du WSDL...

Le serveur SOAP de PHP propose les mêmes facilités que pour le client, hormis pour la description WSDL qui doit être réalisée par un autre biais. Dans ce cas, le serveur « sert » le Service WEB selon les spécificités décrites dans le WSDL.

IV-A. Exemple de consommation de Service WEB via le client SOAP PHP▲

<?php
/**
 * Invocation simple à un Service WEB : la classe SoapClient() comporte des paramètres supplémentaires 
 * qui seront intéressants à étudier dans la documentation
 */

//On doit passer le fichier WSDL du Service en paramètre de l'objet SoapClient()
$wsdl="http://www.xmethods.net/wsdl/query.wsdl";
$service=new SoapClient($wsdl);

//À partir de là, on peut déjà faire appel aux méthodes du service décrites dans le WSDL
$taballservices=$service->getAllServiceSummaries();

//On renvoie le résutat de notre méthode, pour voir....
print_r($taballservices);

IV-B. Exemple de Service WEB via le serveur SOAP PHP▲

<?php
/**
 * Classe qui va nous servir à tester le serveur SOAP : il s'agit d'une classe classique...
 *
 */

class DateServeur{

		function retourDate(){
		
		$serveur=$_SERVER['SERVER_SIGNATURE'];
		$date=date("d/m/Y");
		
		$tab['serveur']=$serveur;
		$tab['date']=$date;
		
		return $tab;
	}
}

<?xml version='1.0' encoding='UTF-8'?>

<!-- WSDL file generated by Zend Studio. -->

<definitions name="exemple" targetNamespace="urn:exemple" xmlns:typens="urn:exemple" xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" 
xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:typens0="http://192.168.0.19/experiences/essai_instance.php">
	<message name="retourDate"/>
	<message name="retourDateResponse">
		<part name="retourDateReturn"/>
	</message>
	<portType name="essai_instancePortType">
		<operation name="retourDate">
			<input message="typens:retourDate"/>
			<output message="typens:retourDateResponse"/>
		</operation>
	</portType>
	<binding name="essai_instanceBinding" type="typens:essai_instancePortType">
		<soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
		<operation name="retourDate">
			<soap:operation soapAction="urn:essai_instanceAction"/>
			<input>
				<soap:body namespace="urn:exemple" use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
			</input>
			<output>
				<soap:body namespace="urn:exemple" use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
			</output>
		</operation>
	</binding>
	<service name="exempleService">
		<port name="essai_instancePort" binding="typens:essai_instanceBinding">
			<soap:address location="http://192.168.0.19/experiences/essai_instance.php"/>
		</port>
	</service>
</definitions>

<?php
/**
 * Déclaration d'une classe qui contiendra les méthodes de Service WEB, et instanciation de la classe SoapServer
 * pour rendre notre Service disponible
 *
 */

//Cette classe pourra contenir d'autres méthodes accessibles via le SoapServer
class DateServer{
	
	//On déclare notre méthode qui renverra la date et la signature du serveur dans un tableau associatif...
	function retourDate(){

		$tab = array(
			'serveur' => $_SERVER['SERVER_SIGNATURE'],
			'date' => date("d/m/Y")
		);

		return $tab;
	}
}

//Cette option du fichier php.ini permet de ne pas stocker en cache le fichier WSDL, afin de pouvoir faire nos tests
//Car le cache se renouvelle toutes les 24 heures, ce qui n'est pas idéal pour le développement
ini_set('soap.wsdl_cache_enabled', 0);

//L'instanciation du SoapServer se déroule de la même manière que pour le client : voir la doc pour plus d'informations sur les 
//Différentes options disponibles 
$serversoap=new SoapServer("http://192.168.0.19/experiences/exemple.wsdl");

//Ici nous déclarons la classe qui sera servie par le Serveur SOAP, c'est cette déclaration qui fera le coeur de notre Servie WEB.
//Je déclare que je sers une classe contenant des méthodes accessibles, on peut aussi déclarer plus simplement des fonctions
//par l'instruction addFunction() : $serversoap->addFunction("retourDate"); à ce moment-là nous ne faisons pas de classe.

//Noter le style employé pour la déclaration : le nom de la classe est passé en argument de type String, et non pas de variable...
$serversoap->setClass("DateServer");


//Ici, on dit très simplement que maintenant c'est à PHP de prendre la main pour servir le Service WEB : il s'occupera de l'encodage XML, des
//Enveloppes SOAP, de gérer les demandes clientes, etc. Bref, on en a fini avec le serveur SOAP !!!!
$serversoap->handle();

<?php
/**
 * Invocation du Service WEB que nous venons de créer
 */


//Cette option permet d'éviter la mise en cache du WSDL, qui se renouvelle toutes les 24 heures... Pour le développement, ce n'est pas génial !!!
ini_set('soap.wsdl_cache_enabled', 0);

//On doit passer le fichier WSDL du Service en paramètre de l'objet SoapClient
$service=new SoapClient("http://192.168.0.19/experiences/exemple.wsdl");

//On accède à la méthode de notre classe DateServeur, déclaré dans notre SoapServer
$taballservices=$service->retourDate();

//On renvoie le résutat de notre méthode, pour voir...
print_r($taballservices);

Ces petits exemples vous ont permis d'aborder les concepts liés aux Services WEB, autant pour la consommation que pour les servir. Si vous désirez aller plus loin (et nul doute que vous le voulez : l'architecture SOA est très attirante), je ne peux que vous conseiller la documentation officielle, un annuaire UDDI et un peu de temps libre. Il serait dommage de passer à côté de ce style de service alors que PHP5 nous permet une telle simplicité d'utilisation !!!

Le plus difficile à mon avis, reste l'écriture du fichier WSDL. Les logiciels les écrivant automatiquement sont encore rares, peu pratiques ou alors coûteux.

L'architecture SOA a notamment pour but de réunir des technologies hétérogènes autour de standards, en l'occurrence SOAP et XML. On peut envisager dès lors de faire fonctionner ensemble, par exemple : une application écrite en PHP (logique applicative, accès en base de données) et via les Services WEB lier une interface graphique de type RIA (Rich Internet Application) telle Flex ou bien Open Laszlo afin d'en présenter le résultat.