Migrer vers Sylius 2 : version cible et expert à choisir
Si votre boutique tourne sous Sylius 1.14, il reste deux mois avant la fin de son support de sécurité, prévue le 31 décembre 2026. Pour une migration qui démarre aujourd'hui, la cible logique est Sylius 2.3. Faites d'abord auditer le code, car c'est le niveau de personnalisation qui décide de l'effort, pas la taille du catalogue.
Je suis développeur Sylius indépendant : j'ai donc un intérêt dans ce sujet, et je le signale. Les dates et les points techniques ci-dessous renvoient à des sources que vous pouvez vérifier.
Où en est votre version ?
| Version | Correctifs de sécurité | Que faire |
|---|---|---|
| 1.13 et antérieures | Terminés | Passer en 1.14.21 immédiatement, puis préparer Sylius 2 |
| 1.14 | Jusqu'au 31 décembre 2026 | Installer 1.14.21 et lancer la migration |
| 2.0 | Terminés | Monter vers une version maintenue |
| 2.1 | Terminés depuis le 30 septembre 2026 | Monter vers une version maintenue |
| 2.2 | Jusqu'au 31 mars 2027 | Installer 2.2.12 et planifier la 2.3 |
| 2.3 | En cours | Installer 2.3.2 ou une version plus récente |
Ces dates viennent du suivi endoflife.date, relevé le 31 octobre 2026. Les numéros corrigés viennent de l'annonce de sécurité de Sylius.
Pourquoi ne pas attendre
En octobre 2026, Sylius a corrigé six failles signalées, dont un contournement d'autorisation sur l'API de la boutique en version 2.x, qui exposait les données d'autres clients. L'annonce précise que les versions sorties du support restent touchées là où le code vulnérable existe : il faut alors mettre à jour ou appliquer soi-même un contournement. Après le 31 décembre, ce sera le cas de la 1.14 pour toute nouvelle faille.
Pourquoi viser la 2.3
Sylius 2.3, sortie le 28 septembre 2026, apporte plusieurs changements utiles pour une migration :
- Socle : PHP 8.3 minimum, avec Symfony 6.4, 7.4 ou 8 au choix.
- Paiement : l'API Payment Request n'est plus expérimentale.
- Listes d'administration : la configuration en PHP devient la norme, et une option conserve vos listes YAML le temps de les migrer.
- API : API Platform 4.3 ou 5 au choix. Avec API Platform 5, Symfony 7.4 ou 8 est requis.
Viser la 2.2 peut se défendre si une extension indispensable n'est pas encore compatible avec la 2.3. Il faudra alors remonter avant la fin mars 2027.
Ce qui change entre la 1.14 et la 2.0
Le guide officiel de mise à niveau prévient que même une application peu personnalisée demandera des ajustements manuels. Les postes à chiffrer sont les suivants :
- Thème et gabarits : l'interface passe à Bootstrap et aux composants Symfony UX, avec les Twig Hooks. Chaque surcharge doit être revue.
- Cycle de vie des commandes : winzou/state-machine laisse la place à Symfony Workflow. Vos règles de commande personnalisées sont directement concernées.
- Paiement : vos passerelles sur mesure sont à tester de bout en bout, y compris les remboursements.
- API : les noms des pare-feu et le contrat de l'API évoluent. Vos applications et connecteurs sont à vérifier.
- Extensions : chacune doit exister en version compatible, sinon il faut la remplacer ou la reprendre.
Pour le détail technique, lisez aussi mon guide de migration de Sylius 1.x vers 2.0.
La méthode en cinq étapes
- Sécuriser : installez le dernier correctif de votre version et notez les éventuels contournements nécessaires.
- Inventorier : listez les surcharges, extensions, passerelles de paiement, connecteurs et règles de commande.
- Tester l'existant : couvrez le tunnel de commande, le paiement, les remboursements et les factures avant de toucher au code.
- Migrer sur une copie : suivez les notes de mise à niveau version par version, avec une copie récente des données.
- Répéter la bascule : chronométrez-la, préparez le retour arrière, puis surveillez les commandes et les paiements après la mise en ligne.
Agence ou indépendant : qui choisir en France ?
| Votre situation | Choix logique | Où chercher |
|---|---|---|
| Besoin d'une équipe, de plusieurs métiers ou d'un partenaire reconnu par Sylius | Agence partenaire | Annuaire officiel des partenaires Sylius |
| Périmètre clair, envie de parler directement à la personne qui code | Développeur indépendant | Plateformes de freelances, recommandations, ma page de présentation |
| Équipe interne déjà en place | Audit ponctuel et relecture | L'un ou l'autre, sur une mission courte |
Six questions à poser avant de signer
- Quelle migration comparable pouvez-vous me montrer, et de quelle version vers quelle version ?
- Qui écrira réellement le code ?
- Quelle version visez-vous, et pourquoi ?
- Comment testez-vous le paiement, les remboursements et les factures ?
- Comment se déroule le retour arrière si la bascule échoue ?
- Qui assure les mises à jour de sécurité après la mise en ligne ?
Une réponse floue à la première ou à la cinquième question doit vous alerter, quelle que soit la taille du prestataire.
Ce que je peux montrer
Sur la boutique belge Coucouroucoucou, environ 15 000 commandes ont été reprises sous Sylius sans coupure de vente et 14 écrans ont été écrits sur mesure. Il s'agit d'une reprise de boutique, pas d'une preuve sur votre version : demandez-moi, comme aux autres, ce qui correspond à votre cas.
Faire le point sur votre boutique
Indiquez-moi votre version, vos extensions et la date que vous visez sur la page développeur Sylius freelance. Je vous dirai par quoi commencer et si une agence vous conviendrait mieux.