Blog de Jérémie Bertrand » PHP

WebService PHP consommé par une application C#

laedit — Wed, 18 Mar 2009 20:57:48 +0000

Pour créer un WebService facilement en PHP, il faut travailler en PHP5 avec l’extension SOAP d’activée. Pour cela, le mieux est de travailler en local avec Wamp Server (Wamp 5), qui permet d’activer cette extension.

Une fois le matériel prêt, on va commencer par ouvrir notre éditeur de PHP préféré et d’écrire la classe qui être utilisé par le WebService.
Dans notre exemple, on va juste définir une petite classe chargée de faire une opération et une soustraction :

class Math
{

public function Add($a, $b)
{
return $a + $b;
}

public function Substract($a, $b)
{
return $a - $b;
}

}

Voilà donc les méthodes qui seront exposées part le WebService.
Il ne reste plus qu’à créer le serveur et la partie PHP sera terminée.
Pour cela, nous allons utiliser la classe SoapServer :

require 'Math.class.php';

// première étape : désactiver le cache wsdl lors de la phase de test
ini_set("soap.wsdl_cache_enabled", "0");

$wsdl = 'WebService.wsdl';
//Création du serveur SOAP avec le fichier WSDL
$server = new SoapServer($wsdl);
//Ajout de la classe Math dans les éléments proposés par le WebService
$server->setClass('Math');

//l'utilisation du WebService se fera toujours par la méthode POST
if ($_SERVER["REQUEST_METHOD"] == "POST")
{
$server->handle();
}
else //dans le cas contraire, la page affichera les méthodes proposées par le WebService
{
echo '

Ce serveur SOAP peut gérer les fonctions suivantes :

'.$func.'

';
}

Vous avez sûrement remarqué qu’on fait appel au fichier WebService.wsdl alors qu’on ne l’a pas encore créé. On va donc s’en charger maintenant. Le mieux pour cela est d’utiliser un logiciel qui va générer le fichier wsdl finale grâce à des informations qu’on lui aura apporté. Pour ma part j’utilise Altova XML Spy qui est disponible gratuitement en version d’essai.
Voilà donc ce que ça donne en version graphique :

La partie serveur est à présent terminée, attaquons nous au client .net en C#.

L’utilisation de Visual Studio 2008 est conseillé, il permet la génération automatique d’un proxy grâce a WCF à partir du fichier WSDL.
On va commencer par créer une application console. Ensuite, il suffit d’ajouter une un Service Reference en passant en adresse celle du fichier WSDL (http://localhost/WebServices/WebService.wsdl dans notre cas) et Math comme namespace pour la référence.

WCF a alors généré la classe MathServiceClient ainsi qu’un fichier de configuration qui vont nous servir à intéragir avec le WebService.
On va instancier cette classe :

MathServiceClient math = new MathServiceClient();

Puis on va simplement appeler nos deux méthodes :

Console.WriteLine(math.Add(5, 5));
Console.WriteLine(math.Substract(10, 5));

Et bien sûr, il ne faut pas oublier de fermer le client :

math.Close();

Et voilà, notre client .net consomme notre WebService PHP !

Les sources de cet article sont disponibles ici.

Interopérabilité PHP / C# via WebService

laedit — Wed, 18 Mar 2009 20:51:52 +0000

Interopérabilité est peut être un bien grand mot pour décrire ce qui va suivre. En effet, dès que l’on parle de WebService, il suffit d’avoir un fichier WSDL pour qu’on puisse consommer le WebService par une application d’un autre langage. Nous verrons donc dans un premier temps ce qu’est un fichier WSDL, puis la création d’un WebService en PHP consommé par une application .NET en C# et inversement.

Qu’est-ce qu’un fichier WSDL ?

Juste une rapide présentation, pour plus d’information, vous pouvez aller voir ici (http://www.w3.org/TR/wsdl).
Le fichier WSDL décrit une Interface publique d’accès à un Service Web, notamment dans le cadre d’architectures de type SOA (Service Oriented Architecture).
C’est une description fondée sur le XML qui indique « comment communiquer pour utiliser le service »;

Il décrit notamment le Protocole de communication (SOAP RPC ou SOAP orienté message), le format de messages requis pour communiquer avec le service, les méthodes que le client peut invoquer ainsi que la localisation du service.
Le fichier WSDL est un fichier XML qui commence par la balise et qui contient les balises suivantes :
- : définit le protocole à utiliser pour invoquer le service web
- : spécifie l’emplacement actuel du service
- : décrit un ensemble de points finaux du réseau

Les opérations possibles et messages sont décrits de façon abstraite mais cette description renvoie à des protocoles réseaux et formats de messages concrets.
Il y a différents moyens de réaliser ce fichier, certaines seront décrites dans cet article, mais étant donné que c’est du XML, un simple bloc note suffit !

Dans ce post, on verras un WebService PHP consommé par une application C#.

Et dans celui-là, un WebService C# en WCF consommé par une application PHP.

WebService C# en WCF consommé par une application PHP

laedit — Tue, 27 Oct 2009 16:23:08 +0000

Faisant suite après quelques mois à l’article sur le webservice PHP consommé par une application C#, nous verrons ici l’inverse.

Je ne vais pas détailler WCF ici, nous allons juste voir la mise en place d’un service via une application console. Si vous souhaitez en savoir plus sur WCF, voilà l’excellent article de Julien Corioland. (http://blogs.dotnet-france.com/julienc/post/Introduction-a-Windows-Communication-Foundation.aspx)

Nous garderons les mêmes méthodes que dans le post précédent, c’est-à-dire une addition et une soustraction d’entiers.

Commençons donc par définir l’interface du service :

[ServiceContract]
public interface IService
{
[OperationContract]
public int Add(int a, int b);
[OperationContract]
public int Substract(int a, int b);
}

L’attribut ServiceContract définit le contrat du service qui sera exposé. Il possède une propriété Namespace qui permet de changer le namespace du service (tempuri.org par défaut).
L’attribut OperationContract définit les méthodes visibles du service.

Passons à l’implémentation du service :

public class Math : IService
{
#region IService Members

public int Add(int a, int b)
{
return a + b;
}

public int Substract(int a, int b)
{
return a - b;
}

#endregion
}

Jusque là, rien de bien compliqué, il suffit d’implémenter l’interface définie plus haut. Passons maintenant au serveur, qui exposera le service WCF.

L’application sera une application console des plus classique. La première chose à faire est de créer un fichier de configuration (App.config) qui va paramétrer le type, l’adresse et le protocole du service.

binding="basicHttpBinding"
contract="ServiceContract.IMathService" />

On créer ensuite un host en lui indiquant le type que l’on veut exposer en service :

ServiceHost host = new ServiceHost(typeof(ServiceImplementation.Math));

Il suffit ensuite de mettre le service en écoute :

host.Open();

Console.WriteLine("Le service Math est à l'écoute");

Console.WriteLine("Appuyez sur une touche pour quitter");

Console.ReadLine();
host.Close();

Le service est maintenant prêt.

Mais le fichier WSDL n’a pas été créé, ce qui manque cruellement pour pouvoir consommer le service avec une application PHP. Heureusement, WCF permet de le générer automatiquement. Pour cela, il suffit de modifier le fichier de configuration.

On va tout d’abord rajouter un comportement au service. Dans la balise System.ServiceModel, on rajoute ceci :

Il faut ensuite modifier la balise service comme suit :

Et voilà, notre service peut maintenant être consommé par n’importe quelle application via son fichier WSDL.

Il ne reste plus qu’à faire le client PHP. Pour cela, le mieux est de générer le client SOAP à partir du fichier WSDL. Je me suis personnellement servi de wsdl2php, disponible ici : http://www.urdalen.no/wsdl2php/, mais d’autre scripts font ça très bien aussi, comme WSDLInterpreter : http://code.google.com/p/wsdl2php-interpreter/.

Une fois le WSDL passé à la moulinette, on obtient donc une jolie classe Math qui hérite de SoapClient et qui possèdent deux fonctions : Add et Substract. Sont également générées les classes qui vont servir à passer les paramètres et à récupérer les résultats : Add qui contient deux entiers, AddResponse qui possède une propriété AddResult qui est le résultat de l’addition, Substract qui contient également deux entiers et SubsctractResponse qui possède une propriété SubstractResult qui est le résultat de la soustraction.

Maintenant qu’on a de quoi consommer le service WCF, il ne reste plus qu’à faire le client PHP. On va tout d’abord créer le fichier client.php. Première chose à ajouter, un include sur le fichier généré par wsdl2php : Math.php.

Ensuite, on va instancier le client du service Math :

$client = new Math();

Il faut maintenant créer les paramètres pour la fonction Add :

$addParameters = new Add();
$addParameters->a = 2;
$addParameters->b = 2;

Vous remarquerez que a et b correspondent aux noms des paramètres de la fonction Add définis par le contrat du service.
On appelle la fonction Add :

$result = $client->Add($addParameters);

On peut ensuite utiliser la propriété AddResult de $result pour récupérer le résultat de l’addition et l’afficher par exemple :

echo $result->AddResult;

Et c’est fini, nous avons maintenant un client PHP qui consomme notre service WCF !

Les sources de cet article sont disponibles ici.