Migrer vers Sylius 2 quand on dépend d'une agence ?

Quand une agence externe tient le code de votre boutique Sylius, la migration vers Sylius 2 se pilote en trois gestes : obtenir d'elle par écrit un inventaire et un calendrier avant le 31 décembre 2026, vérifier que vous gardez la main sur le code, l'hébergement et les comptes, puis faire valider son estimation par un regard indépendant si elle vous paraît floue. Vous n'avez pas besoin de comprendre le code pour piloter ce chantier : vous avez besoin des bonnes questions et des bons accès.

Je suis développeur Sylius indépendant à Metz, et je reçois souvent des dirigeants dans cette situation : la boutique a été construite par une agence, elle tourne, et personne en interne ne sait vraiment ce que va demander la version 2. Voici comment je conseillerais de s'y prendre, que l'agence reste aux commandes ou non.

Pourquoi la dépendance à une agence pèse-t-elle autant sur cette migration ?

Parce que Sylius 2 n'est pas une mise à jour de routine. Le guide officiel UPGRADE-2.0 décrit un changement de socle : nouvelle interface en Bootstrap 5 et Symfony UX, Twig Hooks à la place des anciens événements de gabarits, Symfony Workflow à la place de winzou, API Platform en version 4, symfony/mailer à la place de SwiftMailer. Toutes les personnalisations faites par l'agence sont potentiellement concernées, et c'est elle qui sait où elles se trouvent.

Le calendrier ajoute de la pression. Selon le cycle de publication de Sylius, Sylius 1.14 ne reçoit plus de correctifs de sécurité après le 31 décembre 2026. Si l'agence a beaucoup de boutiques à migrer en même temps, la vôtre n'est peut-être pas en tête de liste. Vous ne le saurez qu'en posant la question.

Quelles questions poser à votre agence dès maintenant ?

Sur le calendrier

Demandez quand elle compte migrer votre boutique, vers quelle version cible et avec quelle date de mise en production. Une réponse du type « on verra en fin d'année » n'est pas un calendrier. Le chemin prévu par Sylius passe d'abord par la 1.14 à jour, sans dépréciations, puis par la 2.x choisie : demandez où vous en êtes sur ce chemin.

Sur le périmètre

Demandez la liste écrite de ce qui sera touché : gabarits surchargés, plugins tiers et leur compatibilité, paiements, API, connexions avec vos outils. Un inventaire écrit vous permet de comprendre ce que vous payez et de comparer. Je détaille ce qu'un devis sérieux doit contenir dans l'article sur le choix d'un prestataire de migration, et la question de la facturation dans ce que votre agence peut vous facturer.

Sur la bascule et l'après

Demandez comment la boutique sera mise en production, combien de temps les ventes seront interrompues, comment on revient en arrière en cas de problème, et qui corrige les anomalies dans les semaines qui suivent. Ce sont les questions qui révèlent si une méthode existe vraiment.

Quels accès devez-vous détenir avant de lancer le chantier ?

C'est le point que les dirigeants découvrent trop tard. Avant toute migration, vérifiez que vous avez au minimum un accès en lecture au dépôt de code, un accès administrateur à l'hébergement, la propriété du nom de domaine et des comptes de paiement, et une sauvegarde récente de la base de données que vous savez où trouver. Si l'un de ces éléments n'est qu'au nom de l'agence, demandez à ce qu'il soit transféré ou partagé maintenant, pendant que la relation est bonne.

Relisez aussi votre contrat. La clause sur les droits du code développé pour vous décide de votre liberté de confier la migration, ou une partie, à quelqu'un d'autre. Sans ces accès, vous ne pouvez ni vérifier un chiffrage, ni changer de prestataire si le calendrier dérape. Je reviens sur ces garanties dans l'article sur comment éviter de dépendre d'un prestataire.

Comment vérifier l'estimation de votre agence sans tout refaire ?

Une contre-expertise n'a rien d'hostile. Elle consiste à faire analyser le même code par une autre personne et à comparer les deux listes. Pour cela, j'utilise Sylius Upgrade Analyzer, l'outil open source que j'ai créé et publié sur le Sylius Store. Il s'exécute sur une copie du projet, passe 49 analyseurs sur les gabarits, les dépréciations, les plugins, les grilles et l'API, et donne une estimation en heures par problème détecté.

Si l'estimation de l'agence et celle du diagnostic sont proches, vous signez sereinement. Si elles divergent fortement, la discussion devient factuelle : tel plugin n'a pas de version 2, tel gabarit est surchargé, tel paiement passe par une passerelle retirée. C'est exactement l'objet du diagnostic de migration offert : un rapport commenté sur votre code, avec une estimation en jours, qui vous appartient même si l'agence garde le chantier.

Garder l'agence, la renforcer ou la remplacer ?

Dans la plupart des cas, la bonne réponse n'est pas de rompre. L'agence connaît votre métier, vos habitudes et l'historique du projet. Si elle répond clairement, avec un calendrier crédible, gardez-la et suivez le chantier avec un point d'avancement régulier et une recette faite par vos propres équipes.

Si elle manque de temps ou de pratique sur Sylius 2, elle peut se faire renforcer. Je travaille aussi en sous-traitance et en marque blanche pour des agences : elles gardent la relation avec leur client, je prends en charge le diagnostic, la préparation sur la 1.14 ou la migration elle-même. C'est souvent la solution la plus douce pour vous comme pour elle.

Le changement de prestataire se justifie seulement quand l'agence ne répond plus, refuse de donner une date ou ne peut pas expliquer son chiffrage. Dans ce cas, les accès dont je parlais plus haut font toute la différence entre une transition de quelques jours et un blocage de plusieurs semaines.

Ce que je vous propose

Si vous dépendez d'une agence et que vous voulez savoir où vous en êtes réellement, je lance Sylius Upgrade Analyzer sur votre projet et je vous remets un diagnostic offert, avec une estimation en jours et la liste des points bloquants. Vous pouvez le transmettre à votre agence, l'utiliser pour challenger son devis ou me confier tout ou partie du chantier. Je vous rappelle sous 24 heures ouvrées. Avec une échéance au 31 décembre 2026, le plus tôt est le mieux.