Este documento apresenta como criar APIs usando o micro-framework PHP Silex. Ele explica o que é uma API e por que criá-las, demonstra um exemplo simples de API de cervejas e mostra como implementar recursos como listar, buscar, criar, atualizar e deletar itens usando Silex.

1. Criando APIs
usando o micro-framework
Silex

2. Elton Minetto
Graduado/pós-graduado em Ciência da Computação
Desenvolvedor desde 1997
Professor desde 2004
Autor de dois livros sobre PHP
Sócio da Coderockr
Instrutor do Code Squad

3. API

4. O que é?

5. "[] conjunto de rotinas e padrões estabelecidos por um
software para a utilização das suas funcionalidades por
aplicativos que não pretendem envolver-se em detalhes
da implementação do software, mas apenas usar seus
serviços []"
Wikipedia

6. Porque criar uma
API?

7. Múltiplas interfaces (web, mobile, CLI)

9. Integração com outros serviços da sua
empresa
Venda de recursos (Amazon, Parse, Pusher,
Filepicker, etc)

10. Exemplo

11. RestBeer

12. API de informações sobre cerveja
http://restbeer.com/cervejas/
http://restbeer.com/estilos/
http://restbeer.com/cervejas/Guinness
http://restbeer.com/cervejas/Heineken
http://restbeer.com/estilos/Pilsen
http://restbeer.com/estilos/Stout

13. Silex

14. Micro-framework para PHP 5.3 (e
superiores) construído com base nos
componentes do Symfony e inspirado no
Sinatra (ruby)

15. Instalando

16. Criando o composer.json
{
"require": {
"silex/silex": "1.0.*"
},
"minimum-stability": "dev"
}
Instalando as dependências
curl -s http://getcomposer.org/installer | php
php composer.phar install

17. Mostrando as
cervejas

18. <?php
use SilexApplication;
//loader do Composer
$loader = require_once __DIR__.'/vendor/autoload.php';
$app = new Application();
$cervejas = array(
'marcas' => array('Heineken', 'Guinness', 'Skol', 'Colorado'),
'estilos' => array('Pilsen' , 'Stout')
);
$app->get('/cervejas', function () use ($cervejas) {
return implode(',', $cervejas['marcas']);
});
$app->get('/estilos', function () use ($cervejas) {
return implode(',', $cervejas['estilos']);
});
$app->run();

19. Testando com o
servidor do PHP 5.4

20. php -S localhost:8080

21. Mostrando uma em
específico

22. $app->get('/cervejas/{id}', function ($id) use ($cervejas) {
if ($id == null) {
return implode(',', $cervejas['marcas']);
}
$key = array_search($id, $cervejas['marcas']);
if ($key === null) {
return 'Não encontrada';
}
return $cervejas['marcas'][$key];
})->value('id', null);

23. Formatando o
resultado

24. //Adicionar os novos namespaces no começo do arquivo
use SymfonyComponentHttpFoundationResponse;
use SymfonyComponentHttpFoundationRequest;
...
//alterar o /cervejas
$app->get('/cervejas/{id}', function ($id) use ($cervejas) {
if ($id == null) {
$result = implode(',', $cervejas['marcas']);
return new Response (json_encode($result), 200);
}
$key = array_search($id, $cervejas['marcas']);
if ($key === null) {
return new Response (json_encode('Não encontrada'), 404);
}
return new Response (json_encode($cervejas['marcas'][$key]),
200);
})->value('id', null);
//adiciona o cabeçalho após todas as requisições
$app->after(function (Request $request, Response $response) {
$response->headers->set('Content-Type', 'text/json');
});

25. Autenticando

26. $app->before(function (Request $request) use ($app) {
if( ! $request->headers->has('authorization')){
return new Response('Unauthorized', 401);
}
require_once 'configs/clients.php';
if (!in_array($request->headers->get('authorization'),
array_keys($clients))) {
return new Response('Unauthorized', 401);
}
});

27. Adicionando uma
Cerveja

28. $app->post('/cervejas', function (Request $request) use ($app) {
//pega os dados
if (!$data = $request->get('cerveja')) {
return new Response('Faltam parâmetros', 400);
}
//Persiste na base de dados (considerando uma entidade do
Doctrine nesse exemplo)
$cerveja = new Cerveja();
$cerveja->nome = $data['nome'];
$cerveja->estilo = $data['estilo'];
$cerveja->save();
//redireciona para a nova cerveja
return $app->redirect('/cervejas/' . $data['nome'], 201);
});

29. Alterando uma
Cerveja

30. $app->put('/cervejas/{id}', function (Request $request, $id) use
($app) {
//pega os dados
if (!$data = $request->get('cerveja')) {
return new Response('Faltam parâmetros', 400);
}
//busca da base de dados
if (!$cerveja = $app['db']->find($id)) {
return new Response('Não encontrada', 404);
}
//Persiste na base de dados
$cerveja->nome = $data['nome'];
$cerveja->estilo = $data['estilo'];
$cerveja->save();
return new Response('Cerveja atualizada', 200);
});

31. Excluindo uma
Cerveja

32. $app->delete('/cervejas/{id}', function (Request $request, $id) use
($app) {
//busca da base de dados
if (!$cerveja = $app['db']->find($id)) {
return new Response('Não encontrada', 404);
}
$cerveja->delete();
return new Response('Cerveja removida', 200);
});

33. Referências

34. Exemplo completo
(com integração com o Docrine e usando SQLite)
https://github.com/eminetto/restbeer

35. http://www.slideshare.net/hhamon/silex-meets-soap-
rest
http://www.slideshare.net/Alganet/rest-faa-o-servio-
direito
http://silex.sensiolabs.org
https://github.com/eminetto/silex-sample
https://github.com/Coderockr/SOA-Server
https://github.com/Coderockr/SOA-Client

36. Contato

37. @eminetto
http://www.eltonminetto.net
http://coderockr.com
http://code-squad.com