Slim Framework: Difference between revisions
Jump to navigation
Jump to search
| (34 intermediate revisions by the same user not shown) | |||
| Line 4: | Line 4: | ||
== Installation == | == Installation == | ||
=== Core === | |||
composer require slim/slim:"4.*" | composer require slim/slim:"4.*" | ||
composer require slim/psr7 | 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 == | == Links == | ||
Latest revision as of 07:27, 5 May 2022
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
.gitignore
vendor/
composer.json autoloader
"autoload": {
"psr-4": {
"App\\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"App\\Test\\": "tests/"
}
}
Run composer dump-autoload to generate the autoloader.
.env file
APP_DEFAULT_TIMEZONE="Europe/London"
templates/base.twig.html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{{ block('title') }}</title>
<link rel="stylesheet" href="/css/pure-min.css">
</head>
<body>
{{ block('content') }}
</body>
</html>
templates/index.twig.html
{% extends 'base.twig.html' %}
{% block content %}
<p>Hello {{ name }}</p>
{% endblock %}
public/index.php
<?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.