Programmation PHP avec Symfony/Migration de Symfony 5 à 6

Programmation PHP avec Symfony

1. Introduction
2. Service
   • Contrôleur
   • Commande
3. Composant
   • HttpClient
   • Évènement
   • Formulaire
   • Mailer
   • Stimulus
4. Bundle
   • Twig
   • Doctrine
   • API

La liste des dépréciations cassantes en Symfony 6 est disponible dans le Profiler d'un projet Symfony 5.4, à la section logs.

Il faut donc procéder aux remplacements ci-dessous avant de lancer la migration proprement dite, qui consiste à rechercher / remplacer dans composer.json, les "5.4.*" par "6.4.*", puis en lançant :

composer update "symfony/*" --with-all-dependencies

YAML

• Dans framework.session, remplacer storage_id: session.storage.mock_file par storage_factory_id: session.storage.factory.mock_file. Erreur sinon : Unrecognized option "storage_id" under "framework.session".

Security.yaml

• Remplacer encoders: par password_hashers:.
• Dans firewalls.main remplacer :
  • anonymous: true par lazy: true. Erreur sinon : Invalid firewall "main": user provider "users_in_memory" not found.
  • guard.authenticators: par custom_authenticator:

Twig

• Remplacer controller(App\\Controller\\HomeController:headerAction) par (App\\Controller\\HomeController::headerAction). Sinon, prendre le nom du contrôleur avec sa méthode visible dans bin/console debug:router --show-controllers en échappant ses antislashs. Erreur sinon : The controller for URI "/_fragment" is not callable.
• Plus de form.createView possible pour dupliquer un formulaire depuis le Twig. On peut donc injecter un tableau de formulaires à la place :

        $forms = [];
        foreach ($myArray as $myLine) {
            $forms[] = $form->createView();
        }

        return $this->render('my_form.html.twig', [
            'forms' => $forms,
        ]);

PHP

• Remplacer les injections de SessionInterface par RequestStack, et appeler sa méthode getSession(). Erreur sinon : "Cannot autowire service... SessionInterface".
• Remplacer AbstractFormLoginAuthenticator par Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;.
• InputBag ne peut plus contenir de type non scalaire (ex : tableau). Il faut donc remplacer par exemple :
  • $request->request->get('mon_tableau') par $request->request->all()['mon_tableau'].
  • $request->query->get('mon_tableau') : idem.

Rector

Facultativement, on peut utiliser Rector pour convertir automatiquement les annotations en attributs.

Installation :

 composer require rector/rector --dev
 vendor/bin/rector init

Ensuite, il suffit de mettre les règles voulues dans rector.php :

    $rectorConfig->sets([
        LevelSetList::UP_TO_PHP_81,
        DoctrineSetList::ANNOTATIONS_TO_ATTRIBUTES,
        SymfonySetList::ANNOTATIONS_TO_ATTRIBUTES,
        SensiolabsSetList::FRAMEWORK_EXTRA_61,
    ]);

Si cela ne marche pas (depuis la v1), créer rector.php soit-même :

<?php

declare(strict_types=1);

use Rector\Config\RectorConfig;
use Rector\Doctrine\Set\DoctrineSetList;
use Rector\Set\ValueObject\LevelSetList;
use Rector\Symfony\Set\SymfonySetList;

return RectorConfig::configure()
    ->withSymfonyContainerXml(__DIR__ . '/var/cache/dev/App_KernelDevDebugContainer.xml')
    ->withSets([
        LevelSetList::UP_TO_PHP_82,
        SymfonySetList::SYMFONY_CODE_QUALITY,
        SymfonySetList::SYMFONY_CONSTRUCTOR_INJECTION,
        DoctrineSetList::ANNOTATIONS_TO_ATTRIBUTES,
        SymfonySetList::ANNOTATIONS_TO_ATTRIBUTES,
]);

Puis lancer la modification des fichiers :

 vendor/bin/rector process src

Si les entités modifiées ne marchent plus (is not a valid entity or mapped super class), mettre à jour "doctrine/orm": "^2.9" et dans doctrine.yaml, "type: annotation" par "type: attribute".

Rector est susceptible de convertir des EventListener qui marchent en EventSubscriber qui ne marchent pas.