silex - the symfony2 microframework

μWednesday, March 2, 2011

• phpBB developer

• GH: igorw

• Twitter: @igorwesome

Who?

Wednesday, March 2, 2011

Microframeworks


What?

• Bare bones

• Routes mapped to actions

• The ‘C’ of ‘MVC’

• REST

• Single file app


Why?

• Frameworks are:

• heavy

• verbose

• complex


Sometimes a full-stack framework istoo much for a simple task.


require 'sinatra'

get '/' do 'Hello world!'end


Ian Press Photography


http://www.flickr.com/photos/ianpressphotography/3937459522/

http://www.flickr.com/photos/ianpressphotography/3937459522/

Silex


Silex(by fabpot)


require_once __DIR__.'/silex.phar';

use Silex\Framework;

$app = new Framework();

$app->get('/', function() { return "Hello world!";});






Phar






Instance






Closure


$app->run();


<IfModule mod_rewrite.c> RewriteEngine On RewriteBase /some/path RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^(.*)$ index.php [QSA,L]</IfModule>


Dynamic Routing


$app->get('/hello/{name}', function($name) {

return "Hello $name!";});


Before & After


$app->before(function() use ($conn) { $conn = new PDO('mysql:dbname=myapp');});

$app->get('/', function() use ($conn) { $usernames = array(); $sql = 'SELECT * FROM user ORDER BY email'; foreach ($conn->query($sql) as $row) { $usernames[] = $row['username']; } return implode('<br />', $usernames);});

$app->after(function() use ($conn) { $conn = null;});


REST


use Symfony\Component\HttpFoundation\Response;

$app->post('/blog/post/{id}', function($id) use ($app) { $request = $app->getRequest(); $id = (int) $id; $filename = __DIR__."/data/$id.json"; if (file_exists($filename)) { return new Response('', 409); } file_put_contents($filename, json_encode(array( 'id' => $id, 'title' => $request->get('title'), 'body' => $request->get('body'), ))); return new Response('', 201);});


$app->delete('/blog/post/{id}', function($id) { $id = (int) $id; $filename = __DIR__."/data/$id.json"; if (!file_exists($filename)) { return new Response('', 404); } unlink($filename); return new Response('', 200);});


Errors(Exceptions)


use Monolog\Logger;use Monolog\Handler\FileHandler;use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

$log = new Logger('myapp');$log->pushHandler(new FileHandler(__DIR__.'log/error.log', Logger::ERROR));

$app->error(function(Exception $e) use ($log) { if ($e instanceof NotFoundHttpException) { return new Response( 'What you are looking for does not exist.', 404); }

$log->addError(json_encode(array( 'class' => get_class($e), 'message' => $e->getMessage(), 'code' => $e->getCode(), 'trace' => $e->getTrace(), )));

return new Response('Something very bad happened.', 500);});


How?

• Symfony2

• Extends HttpKernel

• Event Dispatcher

• Routing

• Request & Response


Experimental Fork

• String return value

• Syntactic sugar for routes

• Before & after hooks

• Error handling

• Integration tests


MicroKernelBundle

• Bulat Shakirzyanow (avalanche123)

• More routing flexibility

• Uses instance of Kernel

• Integrates with Symfony2


Recipes


#1 File structure

• app.php

• bootstrap.php

• index.php


app.php

require __DIR__.'/bootstrap.php';



/* routes */

return $app;


bootstrap.php


// custom setup...


index.php

$app = require __DIR__.'/app.php';$app->run();


#2 Service Container


bootstrap.php

use ...\DependencyInjection\ContainerBuilder;use ...\DependencyInjection\Loader\YamlFileLoader;use ...\Config\FileLocator;

$container = new ContainerBuilder();

$env = getenv('APP_ENV') ?: 'dev';

$loader = new YamlFileLoader($container,new FileLocator(__DIR__));

$loader->load("config.$env.yml");


config.dev.yml

services: silex: @silex.framework silex.framework: class: Silex\Framework


app.php

$app = $container->get('silex');


config.dev.ymlparameters: mongo.dbname: myapp

services: mongo.users: class: MongoCollection arguments: [@mongo.db, 'user'] mongo.db: class: MongoDB arguments: [@mongo, %mongo.dbname%] mongo: class: Mongo


app.php

$app->get('/user/{id}', function($id) use ($container) { $users = $container->get('mongo.users'); $user = $user->findOne(array("_id" => $id));

return new Response( json_encode($user), 200, array('Content-Type' => 'application/json') );});


#3 Twig


bootstrap.phpuse Symfony\Component\ClassLoader\UniversalClassLoader;

$loader = new UniversalClassLoader();$loader->registerPrefixes(array( 'Twig_' => __DIR__ . '/vendor/Twig/lib',));$loader->register();

$twigLoader = new Twig_Loader_Filesystem('/views');$twig = new Twig_Environment($twigLoader, array( 'cache' => '/cache/twig', 'debug' => true,));


app.php

$app->get('/about', function() use ($twig) { $template =

$twig->loadTemplate('about.html');

return $template->render(array());});


#4 Testing


use Silex\WebTestCase;


class test extends WebTestCase{ public function createApp() { return require __DIR__.'/app.php'; } // tests...}


public function testAbout(){ $client = $this->createClient();

$client->request('GET', '/about'); $response = $client->getResponse(); $this->assertTrue($response->isOk()); $this->assertContains('trashbin', $response->getContent()); $this->assertContains('github', $response->getContent()); $this->assertContains('igorw', $response->getContent());}


$ phpunit test.php


fork me on github

igorw/Silex


Ω


Questions?


silex - the symfony2 microframework

Technology