PHP5 - Generando WSDL con Zend Studio 5.1

Traducción del original en catalán. Léela en: CatalàEnglish

Parte 1 de 3Servicios web SOAP con PHP5
  1. PHP5 - Generando WSDL con Zend Studio 5.1
  2. PHP5: pasando objetos como parámetro en una llamada SOAP
  3. PHP5: pasando y devolviendo objetos como parámetro en una llamada SOAP (Parte II)

Al programar un webservice con el PHP5 es más que trivial tal como podemos leer en la documentación sobre SOAP (local) del propio PHP. El problema viene cuando queriendo aprovechar la simplicidad de los servicios SOAP toca programar a mano el WSDL. O sea, coge y ponte a definir la interfaz en XML de la/s clase/s que quieres exportar a través del webservice, o sea, una misión imposible.

Mi sorpresa ha sido ver que después de adoptar el Zend Studio como IDE de programación de mi código PHP he visto que disponía de un asistente bien sencillo de usar para generar automáticamente este archivo WSDL. La cosa es bien sencilla, imaginemos que usamos el código del ejemplo de la web de Zend, como comentaba antes.

El servidor SOAP:

<?php
class QuoteService {
  private $quotes = array("ibm" => 98.42);
	function getQuote($symbol) {
    if (isset($this->quotes[$symbol])) {
      return $this->quotes[$symbol];
    } else {
      throw new SoapFault("Server","Unknown Symbol '$symbol'.");
    }
  }
}
	$server = new SoapServer("server2.wsdl");
$server->setClass("QuoteService");
$server->handle();
?>

El cliente, todavía más simple que el servidor:

<?php
  $client = new SoapClient("server2.wsdl");
  print($client->getQuote("ibm"));
?>

Ahora que ya tenemos el código en nuestro Zend, sólo hace falta que vayamos a:

menu.png
generando WSDL con zend studio

Hay que seguir el asistente, que no es demasiado difícil, aquí tenéis los pasos capturados para el ejemplo del que hablamos:

wizard-wsdl-1.png
generando WSDL con zend studio
wizard-wsdl-2.png
generando WSDL con zend studio

Podéis ver cómo se exportan automáticamente las clases de los archivos que seleccionáis, hay que poner al lado de cada clase exportada la URL a través de la cual se accede al servicio:

wizard-wsdl-3.png
generando WSDL con zend studio

Al final obtenemos el archivo WSDL, en nuestro caso este:

<?xml version='1.0' encoding='UTF-8'?>
	<!-- WSDL file generated by Zend Studio. -->
	<definitions name="server2" targetNamespace="urn:server2" xmlns:typens="urn:server2" 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/">
	<message name="getQuote">
		<part name="symbol"/>
	</message>
	<message name="getQuoteResponse">
		<part name="getQuoteReturn"/>
	</message>
	<portType name="QuoteServicePortType">
		<operation name="getQuote">
			<input message="typens:getQuote"/>
			<output message="typens:getQuoteResponse"/>
		</operation>
	</portType>
	<binding name="QuoteServiceBinding" type="typens:QuoteServicePortType">
		<soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
		<operation name="getQuote">
			<soap:operation soapAction="urn:QuoteServiceAction"/>
			<input>
				<soap:body namespace="urn:server2" use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
			</input>
			<output>
				<soap:body namespace="urn:server2" use="encoded" encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
			</output>
		</operation>
	</binding>
	<service name="server2Service">
		<port name="QuoteServicePort" binding="typens:QuoteServiceBinding">
			<soap:address location="http://oriol.joor.net/soap/server2.php"/>
		</port>
	</service>
</definitions>

Si sois observadores notaréis que este archivo es ligeramente diferente al de la documentación que muestra Zend. Pero yo lo he probado y funciona perfectamente, así que no me romperé la cabeza en saber a qué se deben estos pequeños cambios al implementar este formato XML.

5 comentarios

Los comentarios del blog antiguo, tal como se escribieron. Los comentarios están cerrados.

  1. —

    Acabo d'escriure l'article me'n vaig a fer un cop d'ull al bloglines i allà em trobo la notícia de que Zend i IBM, han arribat a un acord perquè Eclipse, la IDE de Java i C++ d'IBM, es posi a treballar per donar suport al PHP com tecnologia integrada dins de la IDE, inicialment el suport serà a través de plug-ins.

    Per més informació sobre el tema la notícia d'Eclipse:

    Eclipse Foundation, Zend Technologies, and IBM Announce the Approval of the PHP IDE Project

  2. Ernest

    Per si algun dia et trobes que vols fer el proces a la inversa

  3. —

    [2]

    ostres que ben parit, gràcies. Tot i que també s'ha de dir que s'han de tenir quadrats per escriure a pelo un WSDL. O això o acabes com el de la foto de l'article del SOAP :)

  4. Ernest

    Aixo es veritat, mes que res es per aprofitar aquells llocs que l'unic que et faciliten es el wsdl pq tu et generis els teus fitxers interficie per utilitzar el servei. Com per exemple la ja antiga api de google

  5. —

    [4] bona idea... veus això no se m'havia acudit. Però realment és una part molt útil de l'eina que comentes. Ja ho intentaré tenir en compte.

    Per cert, ja m'he instal·lat el Zend Studio 5.1 per Linux. De fet, esta programat en Java i treballa sobre el JRE però dins del que cap va prou bé.