PHP RESTful Web Services - PHPConf'09

http://ﬂickr.com/photos/estherase/128983854/

PHP RESTful Web Services
Felipe Ribeiro
felipernb@php.net
http://feliperibeiro.com
@felipernb

Felipe Ribeiro
Graduando (concluinte) em Ciência da Computação na
UFCG
Zend Certiﬁed Engineer - PHP5
Trabalha como desenvolvedor Web e consultor com foco
em performance e escalabilidade de Websites
Experiência em grids computacionais e sistemas distribuídos
Membro fundador do grupo PHP-PB
Contribuidor do PHP e Mozilla Camino

Cloud
computing

SaaS - Software as a
Service

Web Services
• Web service é uma solução utilizada na integração de sistemas
e na comunicação entre aplicações diferentes.

• Padrões Abertos

• Independência

• Sistema Operacional

• Linguagem de Programação

SOAP é o padrão no
mercado...
http://www.ﬂickr.com/photos/katcameron/140299496

Mas SOAP é
complicado!

http://www.ﬂickr.com/photos/jerry7171/192391979/

O SOAP ideal
• Primeiro, você usa UDDI para descobrir aonde estão os
serviços que você está interessado em consumir.

• Depois você vai consumir os arquivos WSDL que descrevem
os serviços com uma ferramenta geradora de clientes de web
services.

• Aí você vai poder ﬁnalmente enviar as requisições dos seus
serviços via HTTP, SMTP, FTP…


Mas o mundo é cruel...
• Registros UDDI são tão lendários que está sendo produzido o
ﬁlme: “Indiana Jones e a ilha do UDDI perdido”

• O único padrão das mensagens é como o formato delas é
deﬁnido (WSDL), quase nenhuma industria de peso tem
formatos de mensagens padronizados;

• Ninguém usa web services em SOAP sem HTTP;

• Nem sempre é fácil fazer tecnologia X conversar com
tecnologia Y via SOAP.

• O modo de invocação dos web services mata qualquer
possibilidade de se desenvolver clientes Ajax para eles;

REST -
Representational
State Transfer
http://www.ﬂickr.com/photos/practicalowl/392894653/

• REST não é um envelope XML semelhante ao SOAP

• REST não é um framework/toolkit

• REST não é padronizado pela W3C


• Conjunto de princípios para uma arquitetura baseada em
como a Web funciona

• ROA - Resource Oriented Architecture (Arquitetura orientada a
recursos)

• Utiliza padrões já existentes (HTTP, XML,...)

• Tese de doutorado de Roy Fielding (2000)

• Interface uniforme para acesso aos recursos


HTTP


Requisição HTTP

GET /search?q=phpconf HTTP/1.1
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X
10.6; en-US; rv:1.9.1.5) Gecko/20091102 Firefox/3.5.5
Host: http://google.com
Accept: text/html,application/xhtml+xml,application/xml
Accept-Language: pt-br,en-us,en
Accept-Encoding: gzip,deflate
Accept-Charset: ISO-8859-1,utf-8,*
Keep-Alive: 300
Connection: keep-alive


Requisição HTTP
POST /my_form.php HTTP/1.1
User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X
10.6; en-US; rv:1.9.1.5) Gecko/20091102 Firefox/3.5.5
Host: http://www.example.com
Accept: text/html,application/xhtml+xml,application/xml
Accept-Language: pt-br,en-us,en
Accept-Encoding: gzip,deflate
Accept-Charset: ISO-8859-1,utf-8,*
Keep-Alive: 300
Connection: keep-alive

campo1=valor1&campo2=valor2


Resposta HTTP

HTTP/1.1 200 OK
Date: Fri, 27 Nov 2009 13:56:40 GMT
Server: Apache/2.2.14 (Unix) mod_ssl/2.2.14 OpenSSL/
0.9.8k DAV/2 PHP/5.3.0
Transfer-Encoding: chunked
Content-Type: text/html;charset=ISO-8859-1

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
...


Resposta HTTP
• Códigos HTTP

• 200 - OK

• 404 - Not found

• 500 - Error

• 503 - Forbidden


Princípios REST
http://www.ﬂickr.com/photos/mscolly/145052885

1. Sintaxe universal para
identiﬁcação de recursos - URI

http://www.ﬂickr.com/photos/heather/147388906

E o que são esses recursos?

1. Sintaxe universal para
identiﬁcação de recursos - URI


• Tudo que é importante ao ponto de ser exposto pelo sistema
na web

• São os substantivos

• Todo recurso tem uma URI.


Possíveis recursos
• Fotos no Flickr

• Bookmarks no Delicious

• Atualizações no Twitter

• ...


2 - Um conjunto bem deﬁnido
de operações
http://www.ﬂickr.com/photos/99129398@N00/255783151

• No mundo real existe “polimorﬁsmo” dos verbos, assim
simpliﬁcamos o nosso vocabulário com verbos genéricos que
servem para vários tipos objetos, como CRIAR, PEGAR,
ALTERAR, APAGAR (jogar fora)

• HTTP já oferece as quatro operações que precisamos, GET,
POST, PUT, DELETE.

• Esses são os verbos

• Assim temos uma interface padrão e genérica para todos os
recursos.


• Podemos fazer uma analogia desses verbos da seguinte
maneira

HTTP SQL CRUD
POST INSERT CREATE
GET SELECT RETRIEVE
PUT UPDATE UPDATE
DELETE DELETE DELETE


3 - Um conjunto de diversos
formatos possíveis

• Recursos são conceitos, representações são como lidamos
com eles

• Nem só de XML vive o REST

• Qualquer formato pode ser utilizado para representar um
recurso: XML, JSON, HTML, Texto puro, PDF, imagens (JPEG,
PNG,...) e etc...


4 - Protocolo Stateless
http://www.savagechickens.com/tag/amnesia

• Toda requisição é independente.

• Toda requisição precisa conter toda informação necessária
para que o processamento seja feito.

• Ajuda na escalabilidade e balanceamento de carga.

http://www.savagechickens.com/tag/amnesia

Classiﬁcação
http://www.ﬂickr.com/photos/ogil/2540634421/

REST-RPC (Low REST)
• Utiliza principalmente o método GET para toda a API e a ação
a ser tomada é descrita na própria URI.

• Mais comum por ser mais fácil de implementar


RESTful (High REST)
• Implementação de acordo com a tese de Roy Fielding

• Utiliza os quatro verbos (GET, POST, PUT, DELETE)


• O uso correto ou não dos verbos determina se uma aplicação
é considerada RESTful ou não.
Não RESTful
Verbo URI (substantivo) Ação
POST /bookmarks/create Criar
GET /bookmarks/show/1 Visualizar
POST /bookmarks/update/1 Alterar
GET/POST /bookmarks/delete/1 Apagar
RESTful
Verbo URI (substantivo) Ação
POST /bookmarks Criar
GET /bookmarks/1 Visualizar
PUT /bookmarks/1 Alterar
DELETE /bookmarks/1 Apagar

Queria ver isso
funcionando...

Apache CouchDB
• Um banco de dados orientado a documentos com interface
RESTful

• Os documentos são armazenados no formato JSON schema-
free

• Live demo! (Dêem as mãos e rezem para Murphy!)

Finalmente PHP...

http://www.ﬂickr.com/photos/tobiasschlitt/2644905363/

Implementando
um cliente para o
Twitter

Clientes Twitter são o novo
“Hello World” :-)

Implementando
um cliente para o
Twitter

Usaremos o
Pear::HTTP_Request

Clientes Twitter são o novo
“Hello World” :-)

class TwitterClient {

public $login;
public $senha;
const API_URL = 'http://www.twitter.com/statuses/';

public function tweet($mensagem) {
$conexao = new HTTP_Request(self::API_URL.'update.json');
$conexao->setBasicAuth($this->login, $this->senha);
$conexao->setMethod(HTTP_REQUEST_METHOD_POST);
$conexao->addPostData('status',$mensagem);
if(PEAR::isError($conexao->sendRequest())) {
throw new Exception($conexao->getMessage());
}
}
...
}


public function timeline() {
$conexao = new HTTP_Request(self::API_URL.
'home_timeline.json');
$conexao->setBasicAuth($this->login, $this->senha);
$conexao->sendRequest();
$response = json_decode($conexao->getResponseBody());
foreach($response as $tweet) {
printf("nMensagem: %sn Enviada por %s (%s) em %sn",
$tweet->text, $tweet->user->name,
$tweet->user->screen_name,
date('d/m/Y H:m:s',strtotime($tweet-
>created_at)));
}
}


Provendo um serviço REST
• É muito simples!

• PHP permite que você saiba qual o método HTTP foi utilizado
na requisição, acessando a variável:
$_SERVER[‘REQUEST_METHOD’]

• PHP tem suporte nativo aos formatos mais usuais nas APIs
Rest (XML e JSON)


Pode ser basicão...
<?php

switch($_SERVER['REQUEST_METHOD']) {
case 'GET':
//Retorna os dados...
break;
case 'POST':
//Cria um novo registro...
break;
case 'PUT':
//Altera o registro...
break;
case 'DELETE':
//Apaga o registro...
break;

}
?>

GET
• Tudo o que você precisa está na URL

• Apache mod_rewrite pode cuidar de transformar uma url
amigável em parâmetros disponíveis em $_GET

POST
• Trata-se como um formulário qualquer

• Toda a informação que vem na requisição está disponível em
$_POST

PUT
• Assim como no POST, uma requisição PUT traz os dados no
corpo da requisição

• Mas PHP não tem o array superglobal $_PUT

• Mas podemos “criá-lo” da seguinte forma:

parse_str(file_get_contents("php://input"), $_PUT);

DELETE
• No DELETE assim como no GET, o corpo da requisição não
tem nada.

• O recurso a ser apagado é especiﬁcado na URL

<?php
echo "Dúvidas?";

$card = array(
'nome' => 'Felipe Ribeiro',
'site' => 'http://feliperibeiro.com',
'e-mail' => 'felipernb@php.net',
'twitter' => '@felipernb',
'fone' => '(83) 9979-3161'
);
var_dump($card);
?>

Referências
• Leonard Richardson & Sam Ruby. Restful Web Services,
O’Reilly;

• http://rest.blueoxen.net/cgi-bin/wiki.pl?FrontPage

• http://en.wikipedia.org/wiki/REST

• http://www.lornajane.net/posts/2008/PHP-Rest-Server-part-1-
of-3

• Maurício Linhares , Diga não aos web services

• http://www.slideshare.net/allisson/restful-web-services

http://www.ﬂickr.com/photos/nullalux/2261949240

PHP RESTful Web Services - PHPConf'09

Mais conteúdo relacionado

Mais procurados

Semelhante a PHP RESTful Web Services - PHPConf'09

Mais de Felipe Ribeiro

PHP RESTful Web Services - PHPConf'09