View source for Slim Framework

== Requirements ==

Slim 4 requires PHP 7.2 or greater. The current Ubuntu LTS and Debian stable include 7.4, so this requirement is satisfied on up to date servers.

== Installation ==

=== Core ===

 composer require slim/slim:"4.*"
 composer require slim/psr7

=== Additional libraries ===

 composer require filp/whoops
 composer require twig/twig
 composer require twig/intl-extra
 composer require slim/twig-view
 composer require doctrine/orm
 composer require vlucas/phpdotenv
 composer require php-di/php-di --with-all-dependencies
 composer require phpunit/phpunit --dev

=== Directories ===

 mkdir public
 mkdir src
 mkdir templates
 mkdir tests

=== <code>.gitignore</code> ===

 vendor/

=== <code>composer.json</code> autoloader ===

 "autoload": {
     "psr-4": {
         "App\\": "src/"
     }
 },
 "autoload-dev": {
     "psr-4": {
         "App\\Test\\": "tests/"
     }
 }

Run <code>composer dump-autoload</code> to generate the autoloader.

=== <code>.env</code> file ===

 APP_DEFAULT_TIMEZONE="Europe/London"

=== <code>templates/base.twig.html</code> ===

 <!doctype html>
 <html lang="en">
   <head>
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <title><nowiki>{{</nowiki> block('title') <nowiki>}}</nowiki></title>
     <link rel="stylesheet" href="/css/pure-min.css">
   </head>
   <body>
     <nowiki>{{</nowiki> block('content') <nowiki>}}</nowiki>
   </body>
 </html>

=== <code>templates/index.twig.html</code> ===

  {% extends 'base.twig.html' %}
  {% block content %}
    <nowiki><p>Hello {{ name }}</p></nowiki>
  {% endblock %}

=== <code>public/index.php</code> ===

 <?php
 
 declare(strict_types = 1);
 
 use Psr\Http\Message\ResponseInterface;
 use Psr\Http\Message\ServerRequestInterface;
 use DI\ContainerBuilder;
 use Slim\Factory\AppFactory;
 use Slim\Views\Twig;
 use Slim\Views\TwigMiddleware;
 
 require_once __DIR__ . '/../vendor/autoload.php';
 
 $dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
 $dotenv->load();
 
 date_default_timezone_set($_ENV['APP_DEFAULT_TIMEZONE']);
 
 $containerBuilder = new Container();
 AppFactory::setContainer($container);
 
 $app = AppFactory::create();
 
 $app->addRoutingMiddleware();
 $app->addBodyParsingMiddleware();
 $app->addErrorMiddleware(true, true, true);
 
 $app->get('/hello/[{name}]', function(
   ServerRequestInterface $request,
   ResponseInterface $response,
   array $args
 ): ResponseInterface {
   $name = $args['name'] ?? 'unknown';
   $response->getBody()->write("hello $name");
   return $response;
 });
 
 $app->run();

== Slim Skeleton ==

 composer create-project slim/slim-skeleton my-app

== Adopting in a legacy project ==

How to add Slim to an existing project which doesn't use a framework. Slim is probably the only actively maintained framework where this is possible, as Laravel and Symfony both expect you to use them exclusively.

== Links ==

* [https://www.slimframework.com/ Official site]
* [https://www.slimframework.com/docs/v4/ Slim 4 documentation]

[[Category:PHP]]