Criando e consumindo webservices em PHP 5 e Zend Framework

Web service � uma soluç�o utilizada para integraç�o e comunicaç�o entre diferentes aplicaç�es. Por meio de um web service voc� pode disponibilizar funç�es ou mensagens para qualquer outra aplicaç�o na internet ou em aplicaç�es corporativas internamente.

Al�m disso, tamb�m � poss�vel acessar (consumir) funç�es e mensagens de outros web services. A comunicaç�o � realizada atrav�s do formato XML usando o protocolo HTTP. Atrav�s do XML, que � um formato universal, � poss�vel que aplicaç�es rodando em plataformas diferentes se comuniquem, simplesmente traduzindo seus dados para XML antes da comunicaç�o. J� o protocolo HTTP � o mais utilizado na internet. � atrav�s desse protocolo que voc� pode navegar pelos sites usando seu navegador de prefer�ncia.

Neste contexto, o PHP nos fornece funç�es para trabalhar com web services de forma simples e f�cil. Os dois principais tipos de comunicaç�o com Web Service s�o SOAP e REST. Neste artigo iremos abordar como fazer a comunicaç�o com esses dois tipos de Web Service.

SOAP

SOAP � um protocolo de comunicaç�o baseado em XML que permite que aplicaç�es troquem informaç�es utilizando o protocolo HTTP. Mais especificamente, SOAP � um protocolo para acessar um Web Service. SOAP significa �Simple Object Access Protocol�. Por seguir um padr�o W3C , � independente de plataforma e independente de linguagem de programaç�o. � simples e extens�vel. Por trabalhar com o protocolo HTTP, que � o protocolo mais comum utilizado na internet, ele facilita a comunicaç�o evitando que a transmiss�o seja bloqueada por um firewall ou proxy.

A descriç�o da interface de um web service SOAP � especificado em um documento XML chamado de WSDL (Web Services Description Language). O WSDL descreve o Web service e cont�m informaç�es de como acess�-lo. Ele especifica a localizaç�o do serviço e quais s�o os seus m�todos dispon�veis. Portanto, caso esteja criando um web service que deseja disponibilizar para outros programas, ser� preciso criar o arquivo WSDL.

Existem diversas bibliotecas escritas em PHP para criaç�o de web services SOAP. Por�m, a melhor � a extens�o SOAP nativa para PHP. Esta extens�o requer outra extens�o chamada libxml, que j� vem instalada por padr�o nas vers�es mais recentes do PHP. Portanto, para instalar a extens�o SOAP no Linux basta compilar o php com a opç�o -enable-soap (compilando a partir do c�digo fonte) ou para instalar a extens�o SOAP no Ubuntu basta fazer sudo apt-get install php-soap. No Windows, a extens�o SOAP j� vem habilitada por padr�o.

O PHP disponibiliza duas principais classes para trabalhar com SOAP:

SoapServer: para criar novos webservices e disponibiliz�-los para outros aplicativos.

Neste artigo vamos criar uma pequena aplicaç�o SOAP exemplificando a comunicaç�o entre cliente e servidor. Como vimos anteriormente, nosso servidor SOAP precisa de um arquivo XML, chamado de WSDL, que especifica os m�todos presentes em nosso web service. Por�m, criar um arquivo WSDL manualmente � muito complexo. Infelizmente a classe nativa do PHP SoapServer n�o gera o arquivo WSDL automaticamente.

No PHP � poss�vel operar no modo n�o WSDL, ou seja, sem a necessidade de existir um arquivo WSDL. Neste modo, o cliente de web service n�o conseguir� obter informaç�es importantes, por exemplo o tipo de dados, formataç�o, etc. Assim, operar no modo n�o WSDL n�o � recomendado. Muitas plataformas como .NET, Java ou Ruby, necessitam de um WSDL para poderem funcionar.

No PHP, para gerar WSDL voc� tem dispon�vel algumas ferramentas que auxiliam esse trabalho. Recomendo usar o IDE Zend Studio ou a classe Zend_Soap_AutoDiscover distribu�da com o Zend Framework. Na sess�o sobre Zend_Soap mais adiante neste artigo iremos demonstrar a utilizaç�o do Zend_Soap_AutoDiscover para geraç�o do WSDL.

Vamos agora ao exemplo de uma aplicaç�o SOAP simples. O exemplo apresentado na Listagem 1 temos o nosso servidor SOAP operando no modo n�o WSDL. Portanto, especificamos a opç�o �uri� e passamos �null� para o primeiro par�metro do construtor da classe SoapServer. Depois disponibilizamos a classe SoapServerExemplo no web service contendo as funç�es �mensagem()� e �soma()�.

Listagem 1: Utilizando SOAP sem WSDL - Servidor

<?php
/* Criamos a inst�ncia do SoapServer.
 * A opç�o uri indica o namespace do webservice no servidor.
 * O primeiro par�metro null indica que estamos trabalhando 
 * com um webservice no modo n�o WSDL.  
 */
$options = array('uri' => 'http://127.0.0.1/soap/server/');
$server = new SoapServer(null, $options);

/* 
 * Informamos a classe em que o webservice ir� se basear.
 * Podemos usar tamb�m o m�todo addFunction() para adicionar 
 * funç�es em nosso webservice. 
 */
$server->setClass('SoapServerExemplo');
/*
 * O m�todo handle() processa a requisiç�o SOAP e envia uma resposta 
 * para o cliente.
 */
$server->handle();

/*
 * A classe SoapServerExemplo ser� disponibilizada em nosso 
 * webservice. Portanto temos dispon�veis no webservice os m�todos 
 * mensagem e soma.
 */
class SoapServerExemplo {
	
	public function mensagem($nome)
	{
		return "Boas Vindas $nome !";
	}

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

Em seguida, na Listagem 2 temos o c�digo respons�vel pelo cliente de nosso web service. Ele ir� acessar as funç�es que o nosso servidor disponibiliza. Nesta listagem temos o script que ir� consumir o web service criado anteriormente. Ele est� trabalhando no modo n�o WSDL, portanto � necess�rio especificar os par�metros �location� e �uri� e passar null para o primeiro par�metro do construtor da classe SoapClient. Ap�s isso j� � poss�vel utilizarmos as funç�es do web service: �mensagem()� que ir� retornar uma string de �Boas Vindas� usando o par�metro $nome e a funç�o �soma� que retorna a soma dos dois par�metros especificados na funç�o.

Listagem 2: Utilizando SOAP sem WSDL - Cliente

<?php
/*
 * Criamos a inst�ncia de nosso cliente de webservice.
 * Especificamos a localizaç�o e o namespace do servidor de
 * webservice. 
 * Passando null no primeiro par�metro do construtor indicamos
 * que o webservice ir� trabalhar no modo n�o WSDL.
 */
$options = array(
	'location' => 'http://127.0.0.1/soap/server/server.php',
	'uri' => 'http://127.0.0.1/soap/server/'
);

$client = new SoapClient(null, $options);

/*
 * No Objeto $client podemos usar os m�todos da classe 
 * SoapServerExemplo dispon�vel em nosso webservice.
 */
echo $client->mensagem('Douglas') . "<br />";
echo $client->soma(3, 5) . "<br />"

Ao acessar nosso primeiro web service obtemos o resultado apresentado na Figura 1.

Figura 1: Acesso inicial ao web service

Para enriquecer nosso conhecimento em relaç�o a web services SOAP vamos agora demonstrar a comunicaç�o com o site http://www.amazon.com usando a API SOAP do PHP. Neste exemplo iremos construir um cliente de web service em php que conecta no amazon.com e nos traz o resultado de uma pesquisa de livros referente ao assunto PHP5.

Para podermos trabalhar com web services na Amazon � necess�rio antes fazer um cadastro no site deles e obter determinadas chaves que ser�o usadas em nosso web service como uma esp�cie de credencial. Para isso, acesse o site http://aws.amazon.com/ e faça o seu cadastro selecionando a opç�o Sign Up Now.

Ap�s o cadastro, faça o login no site e copie as chaves necess�rias para nosso web service. Para isso, primeiro clique em Account -> Security Credentials (ver Figura 2).

Figura 2: Recuperando as credenciais

Role a p�gina at� a sess�o �Access Credentials� e copie as chaves �Access Key ID� e �Secret Access Key� (ver Figura 3).

Figura 3: Recuperando as credenciais Access Key ID e Secret Access Key

Ap�s copiar as chaves necess�rias j� estamos prontos para criar nosso web service. O c�digo necess�rio para esta atividade est� apresentado na Listagem 3. Nesta listagem, temos um script que conecta no web service do site da amazon. Para autenticaç�o � necess�rio especificar as chaves obtidas no site de web service da amazon conforme descrito anteriormente. Para consumir este web service � necess�rio configurar alguns cabeçalhos para a requisiç�o SOAP: Timestamp, Acces Key ID e Signature. A signature � criada a partir de um algoritmo especificado na documentaç�o sobre web service no site da amazon. Ap�s isso, fazemos a chamada para a funç�o �itemSearch�. Nos par�metros da chamada especificamos o tipo de pesquisa que desejamos: Livros que contenham a palavra-chave �PHP5�. O retorno da funç�o � um array de objetos contendo diversas informaç�es sobre os itens encontrados pela pesquisa. Desses dados utilizamos somente alguns para serem exibidos na tela: T�tulo do livro, autores, preço, imagem da capa, link para o site da amazon.

Listagem 3: Acessando o web service da Amazon

<?php

/* Copie aqui a Chave ACCESS KEY ID copiada do site da Amazon */
define('ACCESS_KEY_ID', 'xxxxxxxxxxxxxxxxxxxx');
/* Copie aqui a Chave SECRET ACCESS KEY copiada do site da Amazon */
define('SECRET_ACCESS_KEY', 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');

/* URL do web service da Amazon */
$wsdl_url = 'http://webservices.amazon.com/AWSECommerceService/AWSECommerceService.wsdl';
/* inst�ncia da classe SoapClient */
$client = new SoapClient($wsdl_url);

/*
Gera assinatura que deve ser enviada na requisiç�o SOAP.
O algoritmo da assinatura � definido na especificaç�o do
web service da Amazon
*/
$timestamp = gmdate("Y-m-d\TH:i:s\Z");
$string = 'ItemSearch'.$timestamp;
$signature = base64_encode(hash_hmac("sha256", $string, SECRET_ACCESS_KEY, true));

/*
Dados da Requisiç�o: Iremos pesquisar livros que contenham 
a palavra-chave PHP5
*/
$request = array(
'SearchIndex' => 'Books',
'ResponseGroup' => 'Large',
'Keywords' => 'PHP5');

$params = array(
'Request' => array($request)
);

/*
Cabeçalhos SOAP necess�rios para comunicaç�o com amazon
*/
$soapheaders = array (
new soapheader("http://security.amazonaws.com/doc/2007-01-01/", "Signature", $signature),
new soapheader("http://security.amazonaws.com/doc/2007-01-01/", "Timestamp", $timestamp),
new soapheader("http://security.amazonaws.com/doc/2007-01-01/", "AWSAccessKeyId", ACCESS_KEY_ID)
);

/*
Setando os headers SOAP
*/
$client->__setSoapHeaders($soapheaders);
/*
Executando a pesquisa
*/
$livros = $client->__soapCall('itemSearch', array($params));

/*
Iterando nos itens encontrados referente a busca
realizada
*/
foreach($livros->Items->Item as $item) {
/*
Obtem o nome dos autores
*/
$autores = is_array($item->ItemAttributes->Author) 
? implode(" e ", $item->ItemAttributes->Author) 
: $item->ItemAttributes->Author;

/* Preço do livro */	
$preco = @$item->ItemAttributes->ListPrice->FormattedPrice 
?: "-"; 

/*
Exibindo os dados dos livros encontrados
*/
echo <<< _HTML_
<div style="clear:left; width: 300px; padding:5px; 
margin:5px; background:#ddd;">
<a href="{$item->DetailPageURL}"><image src="{$item->SmallImage->URL}" align="left"></a>
<b>{$item->ItemAttributes->Title}</b><br/>
Por {$autores}<br/>
Preço: {$preco}<br/>
</div>    
_HTML_;
}

Agora, ao acessar nossa pequena aplicaç�o, o resultado � realmente muito interessante como podemos observar na Figura 4.

Figura 4: Novo acesso ao web service

Vale destacar aqui que o Amazon Web Service disponibiliza diversas funcionalidades. Utilizamos nesse exemplo apenas uma pequena amostra dessa poderosa ferramenta. Existem bibliotecas, que nos poupam bastante trabalho, dispon�veis em v�rias linguagens de programaç�o, inclusive PHP. Segue o link caso queira se aprofundar mais na �rea de desenvolvimento de web service para Amazon: http://aws.amazon.com/articles/4261.

At� aqui conhecemos uma das formas que o PHP fornece para trabalhar com web services, o SOAP. A partir de agora analisaremos a outra possibilidade: REST.

REST

REST � abreviaç�o de Representational State Transfer ou, em portugu�s, Transfer�ncia de Estado Representacional. O REST difere bastante de outros m�todos de web service como SOAP ou XML-RPC. Primeiro que ele n�o � um padr�o W3C ou qualquer outro. REST n�o possui WSDL. N�o existem frameworks, classes nativas ou extens�es PHP para criaç�o de servidores ou clientes REST.

Web services REST (RESTful � um outro termo para definir web service REST) utilizam os pr�prios recursos do protocolo HTTP (GET, POST, PUT, HEAD) para comunicaç�o entre cliente e servidor. A arquitetura REST � focada principalmente em Recursos e Interfaces. Recursos representam uma funcionalidade geralmente representada por uma �nica URL e os m�todos HTTP funcionam como uma interface para acessar os recursos. Por exemplo, a URL http://127.0.0.1/usuario/28 pode ser um recurso. Chamar essa URL atrav�s do m�todo GET representa que queremos obter detalhes desse usu�rio. J� cham�-la atrav�s do m�todo POST indica que queremos criar um novo usu�rio. Por sua vez, cham�-la atrav�s do m�todo PUT indica que queremos atualizar o registro de um usu�rio e o m�todo DELETE pode ser usado para excluir determinado usu�rio.

Normalmente as respostas de web services REST s�o no formato XML. A extens�o SimpleXML do PHP prov� a melhor interface para interagir com esses dados. A extens�o SimpleXML permite uma maneira muito simples e f�cil para converter dados XML para um objeto que pode ser facilmente manipulado atrav�s de propriedades ou iteraç�o como um array.

Vamos agora a um exemplo bastante interessante de web service REST. O web service ir� conectar-se a uma api REST do site delicious.com. Para quem n�o conhece o site delicious, ele permite criar e gerenciar bookmarks on-line. Caso n�o tenha uma conta no delicious e queira testar o web service abaixo, acesse o site http://www.delicious.com e crie uma conta nova.

Segue na Listagem 4 o c�digo para acessar o web service da delicious. Nesta listagem, temos um web service que conecta na API do site delicious, atrav�s de uma requisiç�o HTTP GET, autenticando com os dados baseados no cadastro que voc� realizou. Essa requisiç�o HTTP � feita diretamente pela classe SimpleXMLElement que j� cria um objeto baseado no retorno da requisiç�o que j� vem no formato XML. Os dados retornados s�o os links favoritos que est�o cadastrados na sua conta do site delicious. Na requisiç�o GET estamos especificando o par�metro tag com o valor �php�. Esse par�metro indica que queremos trazer a lista de favoritos que contenham a tag �php�. Por fim, exibimos a lista obtida na tela.

Listagem 4: Acessando o web service da delicious

<?php
/*
 * As duas vari�veis abaixo definem a sua credencial no site 
 * delicious.com. Caso ainda n�o tenha uma conta acesse o site 
 * http://www.delicious.com e cadastre-se.
 */
$u = 'nomeusuario';
$p = 'senha';

/*
 * A url abaixo � o caminho para a api do delicious 
 * disponibilizado atrav�s de um web service REST. Nesta URL https, 
 * indicamos que queremos trazer os bookmarks que tenham a tag 
 * php presente. A URL � passada para o primeiro par�metro da classe 
 * SimpleXMLElement que faz internamente a requisiç�o HTTP usando a 
 * URL j� criando o objeto referente ao XML retornado pela api.
 */
$fooTag = "https://{$u}:{$p}@api.del.icio.us/v1/posts/all?tag=php";
$bookmarks = new SimpleXMLElement($fooTag, NULL, true);

/*
 * $bookmarks � o objeto criado a partir do XML obtido na URL da
 * api delicious. Temos dispon�veis elementos como href, description, 
 * extended, tag, time e hash.
 */
foreach ($bookmarks->post as $bookmark) {
	echo '<a href="' . htmlentities($bookmark['href']) . '">';
	echo htmlentities(utf8_decode($bookmark['description']));
	echo " (";
	echo htmlentities($bookmark['href']);
	echo ")";
	echo "</a><br />\n";
}

Ao acessar o web service criado, temos o retorno apresentado na Figura 5. Como podemos observar, a p�gina retorna todos os links de favoritos tagueados com o termo �php�.

Figura 5: P�gina de retorno do web service

Web Service REST e SOAP no Zend Framework

Para quem n�o conhece o Zend framework, ele � um dos principais frameworks em PHP existente no momento. Seu foco � permitir que os desenvolvedores criem aplicaç�es web 2.0 modernas. Al�m disso, disponibiliza diversas APIs de consumo de web services para Google, Amazon, Yahoo!, Flickr, Twiiter, entre outros. Essas APIs poupam um tempo de trabalho imenso caso o desenvolvedor tivesse que criar web services diretamente pelas funç�es da extens�o SOAP ou diretamente usando REST.

Al�m das APIs desses serviços j� prontas, o framework da Zend disponibiliza classes para que o desenvolvedor possa criar e consumir web services SOAP e REST. Vamos ver alguns exemplos dessas classes disponibilizadas pelo framework.

A principal utilizaç�o do Zend framework � a criaç�o de aplicaç�es MVC (Model-View-Controller). O MVC � um padr�o de arquitetura de software que visa separar a l�gica de neg�cio da l�gica de apresentaç�o, permitindo o desenvolvimento, teste e manutenç�o isolado de ambos. O modelo (model) � usado para definir e gerenciar o dom�nio da informaç�o e notificar observadores sobre mudanças nos dados. Ele � uma representaç�o detalhada da informaç�o que a aplicaç�o opera. A l�gica de neg�cio adiciona valor sem�ntico aos dados, e quando h� mudança de estado o modelo notifica seus observadores. A vis�o (view) apresenta o modelo num formato adequado ao utilizador, na sa�da de dados, e diferentes vis�es podem existir para um mesmo modelo, para diferentes prop�sitos. J� o controlador (controller) recebe a entrada de dados e inicia a resposta ao utilizador ao invocar objetos do modelo. Ele tamb�m � respons�vel pela validaç�o e filtragem da entrada de dados.

Entretanto, o framework nos possibilita trabalhar fora do padr�o MVC. Nos pr�ximos exemplos iremos trabalhar com o Zend Framework sem utilizar o MVC.

Para baixar o zend framework acesse o link de download (apresentado na seç�o links e baixe a �ltima vers�o do pacote zip vers�o minimal.

Descompacte a pasta em um diret�rio qualquer e ap�s descompactar mova a pasta Zend que est� dentro de library para o diret�rio em que desejar trabalhar os exemplos criados a seguir.

Zend_Soap

No exemplo da Listagem 5 temos o web service SOAP utilizando a classe Zend_Soap_Server do framework. Este web service simplesmente disponibiliza a funç�o metodo1() que retorna uma string baseada no par�metro enviado pelo cliente que est� consumindo este web service. Al�m do web service, o script tem a funç�o de retornar o WSDL caso seja requisitado o par�metro GET �wsdl�. Este exemplo � muito parecido com o nosso web service anterior onde usamos a extens�o SOAP do PHP. A principal diferença � que estamos usando agora o SOAP no modo WSDL.

Para gerar o WSDL usamos a classe Zend_Soap_AutoDiscover que faz todo o trabalho complexo da criaç�o do WSDL. Perceba que sua utilizaç�o � muito simples. � interessante o uso de WSDL quando existem clientes SOAP criados em outras linguagens em que o uso de WSDL � obrigat�rio.

Caso deseje mais informaç�es sobre a classe Zend_Soap_Server, acesse o link http://framework.zend.com/manual/en/zend.soap.server.html.

Listagem 5: Utilizando a classe Zend_Soap_Server

<?php

if(isset($_GET['wsdl'])) {
	/*
	 * Setando a vari�vel wsdl via GET iremos retornar
	 * o WSDL e n�o o web service. Para retornar WSDL
	 * utilizamos o mesmo c�digo do web service, por�m
	 * atrav�s da classe Zend_Soap_AutoDiscover. 
	 */
	require_once('Zend/Soap/AutoDiscover.php');
	$wsdl = new Zend_Soap_AutoDiscover();
	$wsdl->setClass('ServerClass');
	$wsdl->handle();
} else {
	/*
	 * C�digo para criar o web service SOAP. Dessa
	 * vez no modo WSDL. Simplesmente passe a URL
	 * do WSDL como primeiro par�metro para o 
	 * construtor.
	 */
	require_once('Zend/Soap/Server.php');
	$server = new Zend_Soap_Server('http://127.0.0.1/zf_soap_server.php?wsdl');
	$server->setClass('ServerClass');
	$server->handle();
}

/*
 * Os m�todos da classe ServerClass ser�o disponibilizados
 * pelo web service REST. O bloco de coment�rio � utilizado
 * pelo Zend_Soap_AutoDiscover para criar o WSDL
 */
class ServerClass {
	/**
	 * @param string $input
	 * @return string
	 */
	public function metodo1($input) {
		return "Recebido via SOAP: $input";
	}
}

J� na Listagem 6 temos o c�digo para consumir o web service criado anteriormente. Veja que com a utilizaç�o do SOAP no modo WSDL nosso c�digo fica bem mais simples.

Listagem 6: Consumindo o web service definido na Listagem 5

<?php
/*
 * Incluir o arquivo da classe Zend_Soap_Client
 */
require_once('Zend/Soap/Client.php');

/*
 * Criamos a inst�ncia da classe Zend_Soap_Client
 * No primeiro par�metro do construtor � definido
 * a URL para o WSDL
 */
$client = new Zend_Soap_Client('http://127.0.0.1/zf_soap_server.php?wsdl');
/*
 * Fazemos a chamada para a funç�o metodo1()
 */
echo $client->metodo1("ZF Rulez");

Ao acessar o cliente do web service obtemos a tela da Figura 6 como resultado.

Figura 6: Retorno do acesso ao novo web service

A grande vantagem de utilizar o framework da ZEND em nossos web services em SOAP � a facilidade para criar o WSDL. Para mais detalhes sobre a classe Zend_Soap_AutoDiscover acesse o link http://framework.zend.com/manual/en/zend.soap.autodiscovery.html.

Zend_Rest

O Zend Framework disponibiliza uma classe rica e simples para criarmos e consumir web services REST chamada Zend_Rest.

Na Listagem 7 temos um exemplo de web service em REST implementado atrav�s da classe Zend_Rest_Server do Zend Framework. Este web service simplesmente disponibiliza a funç�o metodo1() que retorna uma string baseado no par�metro enviado pelo cliente que esta consumindo este web service. A implementaç�o � muito simples e parecida com que j� vimos anteriormente. Para mais detalhes sobre essa classe acesse o link http://framework.zend.com/manual/en/zend.rest.server.html.

Listagem 7: Utilizando a classe Zend_Rest_Server

<?php
/*
 * Incluir o arquivo respons�vel pela classe 
 * Zend_Rest_Server
 */
require_once('Zend/Rest/Server.php');

/*
 * Funç�o que iremos disponibilizar atrav�s do 
 * web service REST
 */
function metodo1($input) 
{
	return "Recebido via REST: $input";
}

/*
 * Inst�ncia da classe Zend_Rest_Server 
 */
$server = new Zend_Rest_Server();
/*
 * Setamos a funç�o metodo1 atrav�s do web service
 */
$server->addFunction('metodo1');
$server->handle();

Na Listagem 8 temos o c�digo que ir� consumir o web service REST criado anteriormente, dessa vez implementado atrav�s da classe Zend_Rest_Client que funciona como um consumidor de web services REST. Maiores detalhes podem ser obtidos no link http://framework.zend.com/manual/en/zend.rest.client.html.

O prop�sito do web service abaixo � simplesmente executar a funç�o metodo1() dispon�vel pelo web service http://127.0.0.1/zf_rest_server.php.

Listagem 8: Consumindo o web service definido na Listagem 7

<?php
/*
 * Incluir o arquivo respons�vel pela classe 
 * Zend_Rest_Client
 */
require_once('Zend/Rest/Client.php');

/*
 * Inst�ncia do objeto da classe Zend_Rest_Client
 * Passamos como par�metro para o construtor a URL
 * respons�vel pelo web service REST
 */
$client = new Zend_Rest_Client('http://127.0.0.1/zf_rest_server.php');

/*
 * Invocamos a funç�o metodo1 usando o m�todo GET 
 * do protocolo HTTP
 */
echo $client->metodo1("ZF Rulez")->get();

Ao acessarmos o nosso cliente teremos o resultado apresentado na Figura 7.

Figura 7: P�gina de retorno do web service REST

Perceba que em nosso exemplo da classe Zend_Rest_Client fizemos uma requisiç�o GET no link http://127.0.0.1/zf_rest_server.php. A classe Zend_Rest_Client tamb�m disponibiliza outros m�todos referentes ao protocolo HTTP como post(), put(), delete(). A explicaç�o sobre a utilizaç�o desses m�todos j� foi citada anteriormente neste artigo, na sess�o onde falamos sobre o REST.

Como vimos anteriormente, o REST trabalha diretamente em cima do protocolo HTTP sem nenhuma outra linguagem embutida. Portanto, a nossa chamada para o metodo1() na Listagem 8 iria gerar uma query string parecida com: ?method=metodo1&arg1=ZF%20Rulez

Al�m dessa query string, o web service REST pode ser acessado tamb�m utilizando a query string "?method=metodo1&input=ZF%20Rulez". Isso � poss�vel quando temos conhecimento do nome do par�metro passado para o metodo1().

O Zend Framework cont�m classes j� prontas que facilitam o consumo de web services dos principais serviços de comunicaç�o na internet. Entre eles est�o: Amazon, Akismet, Delicious, Ebay, Flickr, SlideShare, Twitter, Yahoo, entre outros. Para maiores detalhes acesse a documentaç�o dessas classes atrav�s do link http://framework.zend.com/manual/en/zend.service.html.

Conclus�o

A construç�o de webservices SOAP e REST em PHP, tanto criando quanto consumindo, � simples e eficiente. A produtividade � alta, pois o programador est� focado realmente nas regras de neg�cio e n�o em detalhes t�cnicos dos protocolos que acontecem por tr�s da comunicaç�o.

REST � conhecido por ser mais simples e f�cil de trabalhar do que SOAP. A maioria dos web services na Internet utilizam REST: Twitter, Yahoo!, Flickr, del.icio.us, etc. Alguns utilizam SOAP e REST como Amazon e eBay. J� o SOAP � mais utilizado em aplicaç�es corporativas e sistemas legados.

Cada um possui suas vantagens e desvantagens. Por exemplo, REST � mais leve e f�cil de criar, n�o necessita de bibliotecas. SOAP tem validaç�es, bibliotecas de desenvolvimento e � f�cil de consumir. Cabe a voc� agora escolher entre REST e SOAP e começar a criar e consumir seus pr�prios web services.