WebService com Zend Framework

Depois de mais de um mês sem escrever nada no blog olha eu aqui de novo!

Hoje vou falar de algo que HOJE é pouco documentado, pouco explicado e MUITO utilizado, vou falar sobre como utilizar web service no ZEND FRAMEWORK, nesse caso SOAP.

Mas O PV me explica ai, o que é um web service? E esse tal de SOAP?

Se você não conhece e preferiu questionar eu fico muito feliz pois a dúvida é o principio da sabedoria e precisamos questionar para aprender. Afinal, ninguém nasceu sabendo.

Um web service é uma maneira de uma aplicação comunicar com um servidor Web. Tradicionalmente, quem interage com um servidor web é um ser humano, através de um browser. Se trocarmos o ser humano por uma aplicação, a interacção passa a ser por webservices.

Podem-se implementar webservices de várias maneiras. Duas delas ganharam notoriedade, por diferentes razões: SOAP e REST

SOAP(que é a que vou explicar aqui nesse artigo) é pegar numa mensagem xml, metê-la num envelope e enviá-la por HTTP (embora o SOAP permita diferentes protocolos de transporte, na prática é HTTP). A resposta vem igualmente num envelope, em xml. 

REST é usar o HTTP como ele foi concebido, com GET, POST, PUT e DELETE (estes últimos dois quase não são utilizados mas estão na especificação desde o início). Ou seja, se sabem fazer submit de forms, sabem usar REST. A diferença é que o submit de um form devolve uma página em html, e um webservice REST devolve uma página em Xml

Acho que nem preciso falar qual é o mais seguro não é? Por isso é nele que vamos "MARTELAR".

Ta legal, e como implementar isso no ZEND FRAMEWORK?

Vou utilizar como exemplo aquele Quick Start que a zend disponibiliza em seu site então faça um download la mesmo blz? 

Ele já vem com 3 controllers configurados ok? Index, Error e GuestbookController... vamos apenas utilizar o IndexController pois é ai que vamos escrever nosso webservice cliente(aquele que consome) e o server(aquele que libera).

1. <?php
2.   /* Carregando a classe que nosso server vai consumir */
3. require_once realpath(APPLICATION_PATH .'/../library/').'/Calculadora.php';
5. class IndexController extends Zend_Controller_Action {
7.     public function init() {
8.         /* Initialize action controller here */
9.     }
11.     public function indexAction() {
12.     }
14.     public function soapserverAction() {
16.         if (isset($_GET['wsdl'])) {
17.             /*
18.              * Usar o Soap AutoDiscover para criacao do WSDL de forma dinamica
19.              */
20.             $autodiscover = new Zend_Soap_AutoDiscover();
21.             $autodiscover->setClass('Calculadora');
22.             $autodiscover->handle();
23.         } else {
24.             // Disponibilizar o webservice atraves do canal:
25.             $soap = new Zend_Soap_Server("http://start.local/index/soapserver?wsdl");
26.             $soap->setClass('Calculadora');
27.             $soap->handle();
28.         }
29.         exit;
30.     }
32.     public function soapclienteAction() {
33.         /* canal de chamada para webservice */
34.         $soap = new Zend_Soap_Client("http://start.local/index/soapserver?wsdl");
35.         echo $soap->soma(11, 2) . PHP_EOL; // imprime 3
36.         echo $soap->subtrai(11, 2) . PHP_EOL; //imprime 9
37.        
38.         exit;
39.     }
41. }

Agora a classe "Calculadora que nosso webservice irá consumir

1. <?php 
   

   /

   *
2.  * Classe calculadora
3.  */
5. class Calculadora {
7.     /**
8.      * Realiza Soma
9.      * @param integer $a
10.      * @param integer $b
11.      * @return integer
12.      */
13.     public function soma($a, $b) {
14.         return $a + $b;
15.     }
17.     /**
18.      * Realiza Subtracao
19.      * @param integer $a
20.      * @param integer $b
21.      * @return integer
22.      */
23.     public function subtrai($a, $b) {
24.         return $a - $b;
25.     }
28.     /**
29.      * Concatena
30.      * @param string $a
31.      * @param string $b
32.      * @return string
33.      */
34.     public function concatena($a, $b) {
35.         return $a ." concatenado com". $b;
36.     }
37. }

Veja que no indexcontroller criamos a action soapcliente e soapserver isso pq é um teste então o cliente e o servidor vão estar no mesmo lugar. O WSDL que vamos carregar é o do link do nosso servidor: http://start.local/index/soapserver?wsdl (onde start.local vc substitue pelo link do seu localhost e/ou site em que isso irá rodar).

Para testar vc acessa o seu WSDL  http://start.local/index/soapserver?wsdl e se ele retornar um XML é com a descrição da sua classe Calculadora ele esta pronto para ser utilizado então para isso esse a action cliente e faça o teste: http://start.local/index/soapcliente

Para finalizar vou explicar o que é esse carinha ai WSDL que significa Web Services Description Language e é uma linguagem baseada em XML utilizada para descrever Web Services funcionando como um contrato do serviço. Trata-se de um documento escrito em XML que além de descrever o serviço, especifica como acessá-lo e quais as operações ou métodos disponíveis.

Imagine que são as regras para trabalhar com o webservice e como assim qualquer desenvolvedor de qualquer tecnologia consegue trabalhar com isso.

Vou disponibilizar um webservice SERVER na WEB para testes o WSDL será:

http://www.profpv.com/index/soapserver?wsdl

Assim todo mundo pode testar, inclusive o método que trabalha com STRING. 
Valeu e até a próxima