Introduction to Slim 3

The Slim framework is a lightweight microframework that gives you the basic framework functionality without all the bloat. Now in version 3, the framework has undergone some dramatic changes since its previous version. Join me as I walk through some of its built-in features and show you how easy it is to work with and get a site up and running quickly.

I’ll also cover the creation of a simple REST API using the framework and how to include different modules for common web application related functionality.

Transcript

1. An Introduction to
   Slim 3
   Chris Cornutt / @enygma Dallas PHP 2016-01
   

   View Slide

2. Slim Framework
   Slim is a PHP micro framework that helps you
   quickly write simple yet powerful web
   applications and APIs. At its core, Slim is a
   dispatcher that receives an HTTP request,
   invokes an appropriate callback routine, and
   returns an HTTP response. That’s it.
   Simple
   Lightweight
   Easy to use & customize
   

   View Slide

3. Slim Framework
   - Basic framework without the “bloat”
   - Not backwards compatible with Slim 2
   - Easily extendible with middleware
   - Composer installable
   What’s included
   

   View Slide

4. Slim Framework
   v2 != v3
   Major breaking changes because of PSR-7 compliance.
   

   View Slide

5. Slim Framework
   use \Psr\Http\Message\ServerRequestInterface as Request;
   use \Psr\Http\Message\ResponseInterface as Response;
   require 'vendor/autoload.php';
   $app = new \Slim\App;
   $app->get('/hello/{name}', function (Request $request, Response
   $response) {
   $name = $request->getAttribute('name');
   $response->getBody()->write("Hello, $name");
   return $response;
   });
   $app->run();
   

   View Slide

6. PSR-7: HTTP Messages
   http://www.php-fig.org/psr/psr-7/
   - HTTP message abstraction
   - From the PHP-FIG standards group
   - RequestInterface & Response Interface
   - Streams
   - Headers, URI, Uploads, Messages
   

   View Slide

7. Slim Framework
   use \Psr\Http\Message\ServerRequestInterface as Request;
   use \Psr\Http\Message\ResponseInterface as Response;
   require 'vendor/autoload.php';
   $app = new \Slim\App;
   $app->get('/hello/{name}', function (Request $request, Response
   $response) {
   $name = $request->getAttribute('name');
   $response->getBody()->write("Hello, $name");
   return $response;
   });
   $app->run();
   

   View Slide

8. Slim Framework: Config
   $config = [
   ‘settings’ => [
   ‘displayErrorDetails’ => true,
   ‘addContentLengthHeader’ => true,
   'logger' => [
   'name' => 'slim-app',
   'level' => Monolog\Logger::DEBUG,
   'path' => __DIR__ . '/../logs/app.log',
   ]
   ]
   ];
   $app = new \Slim\App($config);
   https://www.slimframework.com/docs/objects/application.html#application-configuration
   

   View Slide

9. Slim Framework: Routes
   $app = new \Slim\App();
   $app->get(‘/‘, function($request, $response) {
   echo ‘GET home’;
   });
   $app->post(‘/‘, function($request, $response) {
   echo ‘POST home’;
   });
   $app->run();
   GET, POST, PUT, DELETE, OPTIONS, PATCH
   

   View Slide

10. Slim Framework: Routes
    $app->get(‘/hello/{name}’, function($request, $response, $args) {
    echo ‘GET home: ’.$args[‘name’];
    });
    $app->get(‘/id/{id:[0-9]+}’, function($request, $response, $args) {
    echo ‘GET id: ’.$args[‘id’];
    });
    $app->group(‘/user’, function() {
    $this->>get(‘/view’, function($request, $response) {
    echo ‘GET /user/view’;
    });
    $this->post(‘/view’, function($request, $response) {
    echo ‘POST /user/view’;
    });
    });
    

    View Slide

11. Slim Framework: Routes
    class HomeController
    {
    public function home()
    {
    echo ‘GET /user/home’;
    }
    }
    $container = $app->getContainer();
    $container[‘HomeController’] = function() {
    return new \HomeController();
    };
    $app->get(‘/user/home’, ‘\HomeController:home’);
    

    View Slide

12. Slim Framework: DI
    $config = [
    ‘myobject’ => $obj1
    ];
    $app = new \Slim\App($config);
    $app->get('/hello/{name}', function (Request $request, Response
    $response) {
    $object = $this->get(‘myobject’);
    });
    $app->run();
    https://www.slimframework.com/docs/objects/application.html#application-configuration
    Dependency injection
    

    View Slide

13. Slim Framework: DI
    $app = new \Slim\App();
    $container = $app->getContainer();
    $container[‘myclosure’] = function($container) {
    return (object)[‘foo’ => ‘bar’];
    };
    $app->get('/hello/{name}', function (Request $request, Response
    $response) {
    $object = $this->myclosure;
    });
    $app->run();
    https://www.slimframework.com/docs/objects/application.html#application-configuration
    Dependency injection
    

    View Slide

14. Slim Framework: Request
    $app = new \Slim\App();
    $app->get('/hello/{name}', function ($request, $response) {
    echo $request->getMethod().’ on /hello/{name}’;
    if ($request->isGet()) {
    echo ‘getting!’;
    }
    $query = $request->getUri()-> getQuery();
    echo ‘Accepting: ‘.$request->getHeader(‘Accept’);
    $body = $this->getBody(); // a \Psr\Http\Message\StreamInterface
    echo $body;
    return $response;
    });
    $app->run();
    

    View Slide

15. Slim Framework: Response
    $app = new \Slim\App();
    $app->get('/hello/{name}', function ($request, $response) {
    echo ‘HTTP status: ‘.$response->getStatusCode();
    $newResponse = $response->withHeader(‘Content-Type’, ‘text/plain’);
    $body = $response->getBody();
    $body->write(‘this is output back to the browser!’);
    // Adds “Content-Type: application/json"
    $newResponse = $response->withJson([‘foo’ => [‘bar’]);
    return $response;
    });
    $app->run();
    

    View Slide

16. Slim Framework: Errors
    $app = new \Slim\App();
    $container = $app->getContainer();
    $container[‘errorHandler’] = function() {
    return function ($request, $response, $exception) use ($c) {
    return $c['response']->withStatus(500)
    ->withHeader('Content-Type', 'text/html')
    ->write('Something went wrong!');
    };
    });
    $app->run();
    

    View Slide

17. Slim Framework: Middleware
    class ExampleMiddleware
    {
    public function __invoke($request, $response, $next)
    {
    $response->getBody()->write('BEFORE');
    $response = $next($request, $response);
    $response->getBody()->write('AFTER');
    return $response;
    }
    }
    $app = new \Slim\App();
    $app->add(new \ExampleMiddleware());
    $app->run();
    

    View Slide

18. Slim Framework: Middleware
    class ExampleMiddleware
    {
    public function __invoke($request, $response, $next)
    {
    $response->getBody()->write('BEFORE');
    $response = $next($request, $response);
    $response->getBody()->write('AFTER');
    return $response;
    }
    }
    $app = new \Slim\App();
    $app->get(‘/‘, function($request, $response) {
    })->add(new \ExampleMiddleware());
    $app->run();
    

    View Slide

19. Slim Framework: Twig
    composer require slim/twig-view
    $app = new \Slim\App();
    $container = $app->getContainer();
    $container[‘view’] = function() {
    return function ($request, $response, $exception) use ($c) {
    $view = new \Slim\Views\Twig(‘path/to/templates’, [
    ‘cache’ => false
    ]);
    return $view;
    });
    $app->run();
    

    View Slide

20. Slim Framework: Twig
    $app = new \Slim\App();
    /* Setup from previous slide in container */
    $app->get(‘/‘, function($request, $response) {
    $data = [
    ‘foo’ => ‘bar’
    ];
    return $this->view->render($response, ‘template.php’, $data);
    });
    $app->run();
    

    View Slide

21. Demo time!
    

    View Slide

22. Resources
    https://www.codecourse.com/lessons/learn-slim-3
    https://www.slimframework.com
    https://github.com/slimphp/Slim
    https://github.com/slimphp/Twig-View
    https://github.com/enygma/slim-app-skeleton
    https://github.com/chadicus/slim-oauth2
    

    View Slide