Руководство по обновлению

/**
 * Slim 3 App::__construct($container = [])
 * Раньше настройки передавались в конструкторе
 */
$app = new App([
    'settings' => [...],
]);

/**
 * Slim 4 App::__constructor() метод принимает 1 обязательный и 4 опциональных параметра
 * 
 * @param ResponseFactoryInterface Любая реализация ResponseFactory
 * @param ContainerInterface|null Любая реализация  Container
 * @param CallableResolverInterface|null Любая реализация CallableResolver
 * @param RouteCollectorInterface|null Любая реализация RouteCollector
 * @param RouteResolverInterface|null Любая реализация RouteResolver
 */
$app = new App(...);

/**
 * Slim 3.x поставляется с контейнером Pimple и включает следующий синтаксис
 */
$container = $app->getContainer();

// сервисы назначаются как в массиве
$container['view'] = function (\Psr\Container\ContainerInterface $container){
    return new \Slim\Views\Twig('');
};

/**
 * Slim 4.x не включает библиотеку контейнера. Он поддерживает любую реализацию PSR-11, например PHP-DI
 * Для установки PHP-DI выполните команду <code class="language-plaintext highlighter-rouge">composer require php-di/php-di</code>
 */

use Slim\Factory\AppFactory;

$container = new \DI\Container();

AppFactory::setContainer($container);
$app = AppFactory::create();

$container = $app->getContainer();
$container->set('view', function(\Psr\Container\ContainerInterface $container){
    return new \Slim\Views\Twig('');
});

use Slim\Factory\AppFactory;
// ...
$app = AppFactory::create();
$app->setBasePath('/my-app-subpath');
// ...
$app->run();

$app->group('/user', function(\Slim\Routing\RouteCollectorProxy $app){
    $app->get('', function() { /* ... */ });
    //...
});

<?php
use Slim\Factory\AppFactory;

require __DIR__ . '/../vendor/autoload.php';

$app = AppFactory::create();

// Add Routing Middleware
$app->addRoutingMiddleware();

// ...

$app->run();

<?php
use Slim\Factory\AppFactory;

require __DIR__ . '/../vendor/autoload.php';

$app = AppFactory::create();

/**
 * Middleware маршрутизации должно быть добавлено до ErrorMiddleware
 * Иначе, исключения, брошенные из маршрутизатора не будут обработаны
 */
$app->addRoutingMiddleware();

/**
 * Add Error Handling Middleware
 *
 * @param bool $displayErrorDetails -> В продакшене должно быть установлено значение false
 * @param bool $logErrors -> Параметер передается в дефолтный ErrorHandler
 * @param bool $logErrorDetails -> Показывать подробности ошибок в логе ошибок,
 * который может быть заменен по вашему выбору.

 * Примечание: это middleware должно быть добавлено последним. Все ошибки и исключения из добавленных позже middlware не будут обработаны.
 */
$app->addErrorMiddleware(true, true, true);

// ...

$app->run();

<?php
use Psr\Http\Message\ServerRequestInterface;
use Slim\Factory\AppFactory;
use Slim\Exception\HttpNotFoundException;
use Slim\Psr7\Response;

require __DIR__ . '/../vendor/autoload.php';

$app = AppFactory::create();

$errorMiddleware = $app->addErrorMiddleware(true, true, true);

// Установка обработчика ошибки Not Found
$errorMiddleware->setErrorHandler(
    HttpNotFoundException::class,
    function (ServerRequestInterface $request, Throwable $exception, bool $displayErrorDetails) {
        $response = new Response();
        $response->getBody()->write('404 NOT FOUND');

        return $response->withStatus(404);
    });

// Установка обработчика ошибки Not Allowed
$errorMiddleware->setErrorHandler(
    HttpMethodNotAllowedException::class,
    function (ServerRequestInterface $request, Throwable $exception, bool $displayErrorDetails) {
        $response = new Response();
        $response->getBody()->write('405 NOT ALLOWED');

        return $response->withStatus(405);
    });

<?php
use Psr\Http\Message\ResponseInterface as Response;
use Psr\Http\Message\ServerRequestInterface as Request;
use Slim\Factory\AppFactory;
use Slim\Routing\RouteContext;

require __DIR__ . '/../vendor/autoload.php';

$app = AppFactory::create();

$app->get('/hello/{name}', function (Request $request, Response $response) {
    $routeContext = RouteContext::fromRequest($request);
    $routingResults = $routeContext->getRoutingResults();

    // Получаем все аргументы маршрута, например ['name' => 'John']
    $routeArguments = $routingResults->getRouteArguments();

    // В отличие Slim 3, разрешенные методы маршрута теперь доступны всегда, не только в случаях ошибки.
    $allowedMethods = $routingResults->getAllowedMethods();

    return $response;
});

// ...

$app->run();

<?php
use Slim\Factory\AppFactory;
use Slim\Middleware\MethodOverridingMiddleware;

require __DIR__ . '/../vendor/autoload.php';

$app = AppFactory::create();

$methodOverridingMiddleware = new MethodOverrideMiddleware();
$app->add($methodOverridingMiddleware);

// ...

$app->run();

<?php
use Slim\Factory\AppFactory;
use Slim\Middleware\ContentLengthMiddleware;

require __DIR__ . '/../vendor/autoload.php';

$app = AppFactory::create();

$contentLengthMiddleware = new ContentLengthMiddleware();
$app->add($contentLengthMiddleware);

// ...

$app->run();

<?php
use Slim\Factory\AppFactory;
use Slim\Middleware\OutputBufferingMiddleware;

require __DIR__ . '/../vendor/autoload.php';

$app = AppFactory::create();

/**
 * Доступно 2 режима
 * OutputBufferingMiddleware::APPEND (по умолчанию) - Добавляет к текущему телу ответа
 * OutputBufferingMiddleware::PREPEND - Создает новое тело ответа
 */
$mode = OutputBufferingMiddleware::APPEND;
$outputBufferingMiddleware = new OutputBufferingMiddleware($mode);

// ...

$app->run();