RESTful PHP Web Services

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

PHP RESTful Web Felipe Ribeiro - feliperibeiro.com
felipernb@gmail.com
Services CONAPHP / CONISLI 2008

Quem é esse cabra da peste?
• Felipe Ribeiro

• Graduando em Ciência da Computação na UFCG;

• Natural de Campina Grande, PB;

• Trabalha remotamente como desenvolvedor sênior da
startup Shoprizer.com, com base em Miami, FL;

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 que dizem sobre o SOAP...
• 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 o próximo “Jurassic
Park” vai ter um;

• 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
(Transferência de Estado Representacional)

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


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?


• 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: 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

Finalmente PHP...

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

Implementando 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’]

• Caso a saída seja em XML, você pode usar o SimpleXML para
facilitar sua vida.


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;

}
?>

Ou pode ser mais elaborado...
• Vamos ver como seria um sistema simples de gerenciamento
de bookmarks

• Usaremos o padrão Front Controller e processaremos as
requisições de acordo com o recurso que é desejado (nesse
caso o recurso é o bookmark) e o método HTTP utilizado.

• Talk is cheap... Show me the code!


Consumindo um serviço REST
• Você vai precisar da libcurl, ou do pacote HTTP_REQUEST do
PEAR


Perguntas?

http://www.ﬂickr.com/photos/oberazzi/318947873

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

Obrigado!

Felipe Ribeiro
felipernb@gmail.com
http://feliperibeiro.com

http://www.ﬂickr.com/photos/jaredchapman/482538719

RESTful PHP Web Services

Recommandé

Recommandé

Contenu connexe

Tendances

Tendances (20)

Similaire à RESTful PHP Web Services

Similaire à RESTful PHP Web Services (20)

Plus de Felipe Ribeiro

Plus de Felipe Ribeiro (6)

RESTful PHP Web Services