Tweet
Tweet

Slide 1

Slide 1 text

Hugo Hamon @hhamon

Slide 2

Slide 2 text

Silex meets REST and SOAP

Slide 3

Slide 3 text

What is Silex?

Slide 4

Slide 4 text

No content

Slide 5

Slide 5 text

No content

Slide 6

Slide 6 text

No content

Slide 7

Slide 7 text

http://silex.sensiolabs.org

Slide 8

Slide 8 text

Why choosing Silex?

Slide 9

Slide 9 text

What’s inside?

Slide 10

Slide 10 text

The Silex Philosophy

Slide 11

Slide 11 text

silex.phar cache/ logs/ src/ tests/ vendor/ web/

Slide 12

Slide 12 text

Silex Mantra namespace Symfony\Component\HttpKernel; interface HttpKernelInterface { (Response) function handle(Request $request); }

Slide 13

Slide 13 text

Request Handling require_once __DIR__.'/silex.phar'; $app = new Silex\Application(); $app->get('/hello/{name}', function($name) use($app) { return 'Hello '. $app->escape($name); }); $app->run();

Slide 14

Slide 14 text

Request Handling require_once __DIR__.'/silex.phar'; use Symfony\Component\HttpFoundation\Request; use Symfony\Component\HttpFoundation\Response; $app = new Silex\Application(); $app->get('/hello/{name}', function(Request $request) use($app) { $name = $request->attributes->get('name'); return new Response('Hello '. $app->escape($name)); });

Slide 15

Slide 15 text

$app == DIC

Slide 16

Slide 16 text

Deploying REST Web services

Slide 17

Slide 17 text

REpresentational State Transfer

Slide 18

Slide 18 text

Architecture style

Slide 19

Slide 19 text

Designing REST APIs

Slide 20

Slide 20 text

$app->get('/events', function (Request $request) { $events = array( array('name' => 'OSIDays', 'venue' => 'Bangalore'), array('name' => 'PHP Tour', 'venue' => 'Lille'), array('name' => 'Confoo', 'venue' => 'Montreal'), // ... ); return new Response(json_encode($events), 200, array( 'Content-Type' => 'application/json' )); });

Slide 21

Slide 21 text

$app->post('/event', function (Request $request) use ($app) { // Get POST data or 400 HTTP response if (!$data = $request->get('event')) { return new Response('Missing parameters.', 400); } // Persist data to the database $event = new Event() $event->title = $data['title']; $event->venue = $data['venue']; $event->save(); // Trigger redirect to the newly created record URI return $app->redirect('/event/'. $event->id, 201); });

Slide 22

Slide 22 text

$app->put('/event/{id}', function ($id) use ($app) { if (!$data = $request->get('event')) { return new Response('Missing parameters.', 400); } if (!$event = $app['event_manager']->find($id)) { return new Response('Event not found.', 404); } $event->title = $data['title']; $event->venue = $data['venue']; $event->save(); return new Response('Event updated.', 200); });

Slide 23

Slide 23 text

$app->delete('/event/{id}', function ($id) use ($app) { $event = $app['event_manager']->find($id); if (!$event) { return new Response('Event not found.', 404); } $event->delete(); return new Response('Event deleted.', 200); });

Slide 24

Slide 24 text

Advanced routing

Slide 25

Slide 25 text

$app->get('/archive/{year}/{month}', function ($month, $year) { // ... }) ->bind('archives') // Route name ->value('year', date('Y')) // Default parameter value ->value('month', date('m')) ->assert('year', '\d{4}') // Parameter format ->assert('month', '\d{2}');

Slide 26

Slide 26 text

Events management

Slide 27

Slide 27 text

$app->before(function (Request $request) use ($app) { $user = $request->server->get('PHP_AUTH_USER'); $pwd = $request->server->get('PHP_AUTH_PW'); if ( $app['api_user'] !== $user || $app['api_pwd'] !== $pwd ) { return new Response('Unauthorized', 403); } });

Slide 28

Slide 28 text

$app->after(function (Request $request, Response $response) { // Get URI parameter to determine requested output format $format = $request->attributes->get('format'); switch ($format) { case 'xml': $response->headers->set('Content-Type', 'text/xml'); break; case 'json': $response->headers->set('Content-Type', 'text/json'); break; default: $response->headers->set('Content-Type', 'text/plain'); break; } });

Slide 29

Slide 29 text

Exception and error handling

Slide 30

Slide 30 text

$app->error(function (\Exception $e, $code) { switch ($code) { case 400: $message = 'Bad request.'; break; case 404: $message = 'Page not found.'; break; default: $message = 'Internal Server Error.'; } return new Response($message, $code); });

Slide 31

Slide 31 text

$app['debug'] = true;

Slide 32

Slide 32 text

$app->post('/event', function (Request $request) use ($app) { if (!$event = $request->get('event')) { $app->abort(400, 'Missing parameters.'); } // ... return $app->redirect('/event/'. $event->id, 201); });

Slide 33

Slide 33 text

Logging with Monolog

Slide 34

Slide 34 text

use Silex\Provider\MonologServiceProvider; $app->register(new MonologServiceProvider(), array( 'monolog.logfile' => __DIR__.'/../logs/app.log', 'monolog.class_path' => __DIR__.'/../vendor/monolog/src', ));

Slide 35

Slide 35 text

if ($app['debug']) { $app['monolog']->addInfo('Testing the Monolog logging.'); $app['monolog']->addDebug('Method foo() was called.'); $app['monolog']->addWarning('Missing parameter "bar".'); $app['monolog']->addError('Class Foo does not exist.'); }

Slide 36

Slide 36 text

Database interactions with Doctrine

Slide 37

Slide 37 text

use Silex\Provider\DoctrineServiceProvider; $app->register(new DoctrineServiceProvider(), array( 'db.options' => array( 'driver' => 'pdo_mysql', 'host' => 'localhost', 'user' => 'root', 'dbname' => 'event_demo', ), 'db.dbal.class_path' => __DIR__.'/../vendor/doctrine-dbal/lib', 'db.common.class_path' => __DIR__.'/../vendor/doctrine-common/lib', ));

Slide 38

Slide 38 text

$app->get('/events', function () use ($app) { $query = 'SELECT id, title, venue FROM events'; $events = $app['db']->fetchAll($query); return new Response(json_encode($events)); });

Slide 39

Slide 39 text

Input validation

Slide 40

Slide 40 text

use Silex\Provider\ValidatorServiceProvider; $app->register(new ValidatorServiceProvider());

Slide 41

Slide 41 text

$app['validator']->validate($object);

Slide 42

Slide 42 text

namespace Confeet\Model; use Symfony\Component\Validator\Mapping\ClassMetadata; use Symfony\Component\Validator\Constraints\NotBlank; use Symfony\Component\Validator\Constraints\MaxLength; class Event extends Model { private $title; private $venue; static public function loadValidatorMetadata(ClassMetadata $metadata) { $metadata->addPropertyConstraint('title', new NotBlank()); $metadata->addPropertyConstraint('title', new MaxLength(array('limit' => 50))); $metadata->addPropertyConstraint('venue', new NotBlank()); } }

Slide 43

Slide 43 text

$app->post('/event', function (Request $request) use ($app) { if (!$data = $request->get('event')) { $app->abort(400, 'Missing parameters.'); } $event = new Event() $event->setTitle($data['title']); $event->setVenue($data['venue']); if (count($app['validator']->validate($event)) > 0) { $app->abort(400, 'Invalid parameters.'); } $event->save(); return $app->redirect('/event/'. $event->id, 201); });

Slide 44

Slide 44 text

Template engine

Slide 45

Slide 45 text

§ Fast § Concise and rich syntax § Automatic output escaping § Modern features § Extensible Twig

Slide 46

Slide 46 text

use Silex\Provider\TwigServiceProvider; $app->register(new TwigServiceProvider(), array( 'twig.path' => __DIR__.'/../views', 'twig.class_path' => __DIR__.'/../vendor/twig/lib', ));

Slide 47

Slide 47 text

$app->get('/events.{format}', function ($format) use ($app) { $events = array( array('name' => 'OSIDays', 'venue' => 'Bangalore'), array('name' => 'PHP Tour', 'venue' => 'Lille'), array('name' => 'Confoo', 'venue' => 'Montreal'), // ... ); return $app['twig']->render('events.'.$format.'.twig', array( 'events' => $events, )); }) ->assert('format', 'xml|json');

Slide 48

Slide 48 text

{% for event in events %} {{ event.title }} {{ event.venue }} {{ event.startAt }} {{ event.endAt }} {% endfor %}

Slide 49

Slide 49 text

HTTP Caching & ESI

Slide 50

Slide 50 text

Reverse Proxy Caching

Slide 51

Slide 51 text

use Silex\Provider\HttpCacheServiceProvider; $app->register(new HttpCacheServiceProvider(), array( 'http_cache.cache_dir' => __DIR__.'/../cache', ));

Slide 52

Slide 52 text

$app->get('/events', function () use ($app) { $events = array( array('name' => 'OSIDays', 'venue' => 'Bangalore'), // ... ); $content = $app['twig']->render('events.twig', array( 'events' => $events, )); return new Response($content, 200, array( 'Cache-Control' => 'public, s-maxage=3600', 'Surrogate-Control' => 'content="ESI/1.0"', )); });

Slide 53

Slide 53 text

Edge Side Includes

Slide 54

Slide 54 text

Slide 55

Slide 55 text

$app->get('/metadata', function () use ($app) { return new Response('...', 200, array( 'Cache-Control' => 'public, s-maxage=600', )); });

Slide 56

Slide 56 text

Functional testing

Slide 57

Slide 57 text

Client Crawler PHPUnit

Slide 58

Slide 58 text

class EventApiTest extends Silex\WebTestCase { public function testRecentEvents() { $client = $this->createClient(); $crawler = $client->request('GET', '/events.xml'); $response = $client->getResponse(); $this->assertTrue($response->isOk()); $this->assertEquals(5, count($crawler->filter('event'))); $this->assertRegExp('/OSIDays/', $response->getContent()); ... } }

Slide 59

Slide 59 text

Integrating Zend Soap

Slide 60

Slide 60 text

$path = __DIR__.'/../vendor/zend/library'; $app['autoloader']->registerNamespace('Zend', $path);

Slide 61

Slide 61 text

use Zend\Soap\Server; use Confeet\Model\EventService; $app->get('/gateway', function (Request $request) use ($app) { $server = new Server(); $server->setObject(new EventService($app)); $server->setReturnResponse(true); return new Response($server->handle(), 200, array( 'Content-Type' => 'text/xml' )); });

Slide 62

Slide 62 text

92-98, boulevard Victor Hugo 92 115 Clichy Cedex, France trainings@sensio.com (+33 (0)140 998 211) sensiolabs.com - symfony.com – trainings.sensiolabs.com Ques%ons?