Le code legacy (ou code hérité) désigne du code source existant devenu difficile à comprendre, modifier ou tester. Ce n'est pas nécessairement du mauvais code, mais son contexte a changé : départ des auteurs, documentation absente ou technologies obsolètes.
L'Inhibiteur de Croissance
Il ralentit le développement, augmente le risque de régression et rend le recrutement difficile. Plus on tarde à le traiter, plus le coût de modernisation augmente via le mécanisme de la dette technique.
Modernisation Douce
L'approche consiste à moderniser progressivement : ajouter des tests sur les parties critiques, extraire des modules autonomes et documenter les règles métier. L'audit technique est la première étape indispensable.
Une définition utile : du code qu'on n'ose plus modifier
Michael Feathers, dans Working Effectively with Legacy Code, propose une définition volontairement provocante : le code legacy, c'est du code sans tests. L'âge n'est pas le critère. Une application Symfony de trois ans peut être legacy si personne ne peut vérifier automatiquement qu'une modification ne casse rien ; une application de dix ans peut ne pas l'être si elle est couverte, documentée et régulièrement mise à jour.
En pratique, je reconnais un code legacy à des signaux simples :
- La peur du déploiement — les mises en production sont rares, groupées, faites le vendredi soir « pour avoir le week-end en cas de souci ».
- Les zones interdites — des fichiers que personne ne touche « parce que ça marche », souvent ceux qui portent les règles métier les plus critiques.
- Une version de langage ou de framework hors support — plus de correctifs de sécurité, et des dépendances qui ne s'installent plus sur un environnement récent.
- Une connaissance concentrée — une seule personne sait comment déployer, ou plus personne du tout.
Comment je reprends un code legacy
Mon premier réflexe n'est jamais de réécrire. Le code existant, aussi déroutant soit-il, contient des années de corrections de bugs et de cas limites que personne n'a documentés. L'ordre que je suis :
- Sécuriser ce qui tourne — dépôt de code sous le contrôle du client, sauvegardes vérifiées par une restauration, accès à la production inventoriés.
- Cartographier — modules, flux de données, dépendances obsolètes, zones de risque. L'historique Git montre où le code bouge le plus : c'est là que la dette coûte réellement.
- Poser un filet — quelques tests end-to-end sur les parcours critiques, qui ne demandent aucune modification du code, puis une analyse statique avec une baseline qui fige l'existant et interdit d'en ajouter.
- Moderniser par petites marches — montée de version palier par palier, un changement par commit, chaque étape livrable seule.
Un exemple concret
Le premier projet que je mène pour la direction technique d'Orange est une application de gestion de tickets démarrée en 2015 sous Symfony 2 et AngularJS, pensée pour durer quelques mois. Elle est toujours en production plus de dix ans après. Elle n'est pas devenue legacy parce que chaque montée de version majeure a été faite de manière incrémentale — Symfony 2, puis 3, 4, 5 et 6 — sans réécriture ni interruption de service, et parce que les dépendances sont mises à jour régulièrement, pas quand c'est urgent.
Sur une plateforme SaaS B2B multi-tenant de plus de dix ans, sous Zend Framework 1, la montée vers PHP 8.1 a illustré l'autre face du sujet : les erreurs fatales n'apparaissaient qu'en production, parce que seules les données réelles des clients produisaient les cas limites. La baseline PHPStan contenait déjà ces bugs ; chaque fatal corrigé y a gagné un test qui reproduit le cas réel.
Les pièges à éviter
- Supprimer le code « bizarre » sans comprendre pourquoi il existe : il a souvent été écrit après un incident.
- Faire confiance aveuglément aux outils de migration automatique : Rector raisonne sur la syntaxe, pas sur les effets de bord. Ses suppressions de code mort se relisent en priorité.
- Viser la couverture totale avant de toucher quoi que ce soit : dix tests bien placés sur les parcours critiques protègent mieux que cent tests sur du code qui ne bouge jamais.
Le code legacy n'est pas une fatalité, c'est un actif qui demande simplement une maintenance plus attentive pour redevenir un moteur d'innovation.
Si vous avez hérité d'une application que plus personne ne maîtrise, c'est l'objet de ma prestation de reprise d'application web. Pour la méthode détaillée côté tests, voir aussi mon article sur l'introduction de tests automatisés sur un projet legacy.