Api usando Silex.pdf

Transcript

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 Silex\Application; //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 Symfony\Component\HttpFoundation\Response; use Symfony\Component\HttpFoundation\Request; ... //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