Video tutorial WebService basico con php

En la version 5.0 de PHP (Desconosco si en las anteriores tambien, pero no lo creo) existe una libreria llamada php_soap.dll, esta librería permite, realizar llamadas a metodos y objetos remotos utilizando el protocolo SOAP.

En este ejemplo veremos de una manera muy sencilla como invocar nuestros dos primeros metodos remotos Suma (Que dado dos numero devuelve la suma de ellos) y Resta (que dados dos numeros devuelve la resta de ellos).

Parte I

Parte II

Para lograr esto debemos cumplir con los siguientes pasos:

1. Asegurarnos de tener activada la libreria php_soap.dll.
2. Definir el WSDL del Webservice que vamos a consumir.
3. Implementar el lado del servidor, donde codificaremos y registraremos las dos funciones.
4. Deinir el lado del cliente donde invocaremos las dos funciones.

Activando la libreria php_soap.dll

Para hacer esto nos vamos al archivo de configuracion de php llamado php.ini, en este archivo vamos a buscar el php_soap.dll y verificamos que no este comentado, es decir, que no tenga un ";" punto y coma por delante. Algo asi:

;extension=php_shmop.dll
;extension=php_snmp.dll
extension=php_soap.dll
;extension=php_sockets.dll
extension=php_sqlite.dll

Definir el WSDL

Para aprender mejor como definir tu propio WSDL te recomiendo el siguiente artículo de Desarrolloweb.com. Les recomiendo tener este archivo alojado en el servidor donde se encontrará la funcion. En nuestro caso el WSDL quedará de la siguiente manera:

Código scramble.wsdl

<?xml version ='1.0' encoding ='UTF-8' ?>
<definitions name='Scramble'
targetNamespace='http://localhost/tutoriales/webservice/servidor/scramble.wdsl'
xmlns:tns='http://localhost/tutoriales/webservice/servidor/scramble.wdsl'
xmlns:soap='http://schemas.xmlsoap.org/wsdl/soap/'
xmlns='http://schemas.xmlsoap.org/wsdl/'> 
<message name='sumarRequest'>
<part name='symbol' type='xsd:string'/>
<part name='symbol2' type='xsd:string'/>
</message>
<message name='sumarResponse'>
<part name='Result' type='xsd:string'/>
</message>
<message name='restarRequest'>
<part name='symbol' type='xsd:string'/>
<part name='symbol2' type='xsd:string'/>
</message>
<message name='restarResponse'>
<part name='Result' type='xsd:string'/>
</message> 
<portType name='ScramblePortType'>
<operation name='sumar'>
<input message='tns:sumarRequest'/>
<output message='tns:sumarResponse'/>
</operation>
<operation name='restar'>
<input message='tns:restarRequest'/>
<output message='tns:restarResponse'/>
</operation>
</portType> 
<binding name='ScrambleBinding' type='tns:ScramblePortType'>
<soap:binding style='rpc'
transport='http://schemas.xmlsoap.org/soap/http'/>
<operation name='sumar'>
<soap:operation soapAction='urn:localhost-scramble#sumar'/>
<input>
<soap:body use='encoded' namespace='urn:localhost-scramble'
encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'/>
</input>
<output>
<soap:body use='encoded' namespace='urn:localhost-scramble'
encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'/>
</output>
</operation>
<operation name='restar'>
<soap:operation soapAction='urn:localhost-scramble#restar'/>
<input>
<soap:body use='encoded' namespace='urn:localhost-scramble'
encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'/>
</input>
<output>
<soap:body use='encoded' namespace='urn:localhost-scramble'
encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'/>
</output>
</operation>
</binding> 
<service name='ScrambleService'>
<port name='ScramblePort' binding='ScrambleBinding'>
<soap:address location='http://localhost/tutoriales/webservice/servidor/sumar.php'/>
</port>
</service>
</definitions>

El archivo scramble.wsdl debe tener el targetNamespace con la ubicacion de si mismo. Tambien debemos recordar colocar la direccion del archivo del servidor (que en este tutorial se llama sumar.php), esta direcicon se coloca en la seccion Service:

<service name="'ScrambleService'">
<port name="'ScramblePort'" binding="'ScrambleBinding'">
<soap:address location="'http://localhost/tutoriales/webservice/servidor/sumar.php'/">
</soap:address>
</port></service>

Implementando el lado del Servidor:

En este lado vamos a crear nuestras dos funciones Sumar y Restar:

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

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

Tambien es necesario decirle al cache del SOAP cuales son las funciones de las que le hablamos en el WSDL, para eso colocaremos el siguiente codigo:

// turn off the wsdl cache
ini_set("soap.wsdl_cache_enabled", "0");

$server = new SoapServer("scramble.wsdl");

$server->addFunction("sumar");
$server->addFunction("restar");

$server->handle();

Al final tendremos un archivo llamado "sumar.php" con el siguiente codigo:

Código sumar.php

<?php
function sumar($a,$b)
{
return $a+$b;
}
function restar($a,$b)
{
return $a-$b;
}
// turn off the wsdl cache
ini_set("soap.wsdl_cache_enabled", "0");
$server = new SoapServer("scramble.wsdl");
$server->addFunction("sumar");
$server->addFunction("restar");
$server->handle();
?>

Definir el lado del Cliente

Para el cliente primero creamos un formulario donde se introduciran los dos numeros que deseamos sumar, luego (si ya se recibieron los dos numeros por el metodo POST) lo que tenemos que hacer es crear un objeto SoapClient diciendole la ubicacion de nuestro WSDL, luego podremos llamar a los metodos sumar y restar como si fueran metodos de este objeto. El codigo del archivo client.php nos queda de la siguiente manera:

Código client.php

<form id="form1" name="form1" method="post" action="">
<table width="23%" border="0" cellspacing="0" cellpadding="0">
<tr>
<td>a: </td>
<td><input name="a" type="text" id="a" size="5" /></td>
</tr>

<tr>
<td>b: </td>
<td><input name="b" type="text" id="b" size="5" /></td>
</tr>
<tr>
<td>&nbsp;</td>
<td><input type="submit" name="button" id="button" value="Submit" /></td>
</tr>
</table>
</form>
<?php
if(isset($_POST['a']) && isset($_POST['b']))
{
// turn off the WSDL cache
ini_set("soap.wsdl_cache_enabled", "0");

$client = new SoapClient("http://ejemplos.net78.net/webservice/servidor/scramble.wsdl");

$a = $_POST['a'];
$b = $_POST['b'];

$resultado = $client->sumar($a,$b);
print("La suma de los numeros : $a + $b es:  $resultado <br>");

$resultado = $client->restar($a,$b);
print("La resta de los numeros : $a + $b es: $resultado");
}
?>

Lamentablemente no puedo demostrar este ejemplo funcionando, ya que el hosting php con el que trabajo no tiene habilitada la libreria php_soap.dll. Por ende, solo les puedo dejar un link para descargar el ejemplo.