Wikilivres

Programmation PHP/Migration de Symfony 5 à 6

< Programmation PHP

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

[ Modifier le sommaire ]

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

modifier
  • 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

modifier
  • 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

modifier
  • 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

modifier
  • 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

modifier

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

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"[2] et dans doctrine.yaml, "type: annotation" par "type: attribute".

 

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

Références

modifier
  1. ↑ https://getrector.org/blog/how-to-upgrade-annotations-to-attributes
  2. ↑ https://www.doctrine-project.org/2021/05/24/orm2.9.html
Récupérée de « https://fr.wikibooks.org/w/index.php?title=Programmation_PHP/Migration_de_Symfony_5_à_6&oldid=728922 »