Une couche anti-corruption (anti-corruption layer, ACL) est une frontière de code qui traduit les modèles d'un système externe vers ceux de votre application, pour empêcher les concepts, les noms et les bizarreries de l'autre de « contaminer » votre domaine. Issue du Domain-Driven Design, elle s'incarne souvent dans un bridge ou une façade : tout ce qui vient de l'extérieur y est converti une fois, et le reste du code n'en voit jamais la forme brute.
Traduire, Pas Propager
La couche convertit les réponses externes — souvent verbeuses ou mal nommées — en objets internes propres. Le code métier manipule vos concepts, jamais des tableaux JSON venus d'ailleurs. Le jour où l'API distante renomme un champ ou change sa pagination, un seul fichier est touché : la traduction est centralisée, l'onde de choc s'arrête à la frontière.
Un Seul Point De Contact
Parce que tous les échanges passent par elle, la couche devient l'endroit naturel où poser le cache, les timeouts, la gestion d'erreur et les tests. Derrière une interface, elle se double facilement d'une fausse implémentation : l'application se teste hors-ligne, sans jamais appeler le système externe.
Quand j'en pose une
Je ne la pose pas devant chaque appel HTTP. Elle se justifie quand l'une de ces situations se présente :
- Une migration progressive — le nouveau code doit lire ou écrire dans le legacy pendant des mois. Sans frontière, il finit par reprendre les noms de colonnes et les conventions de l'ancien système, et la migration ne fait que déplacer la dette.
- Une API interne rigide ou instable — un référentiel maison, un annuaire, un outil de ticketing dont le format change sans préavis.
- Un ERP, un PIM ou une marketplace dont le modèle de données ne correspond pas au vôtre : un « article » chez l'un n'est pas un « produit » chez l'autre.
- Un fournisseur qu'on pourrait vouloir changer — l'interface décrit votre besoin, l'implémentation parle au fournisseur. En changer revient à écrire une nouvelle implémentation.
Comment je la construis
- Une interface qui décrit le besoin du domaine, avec vos mots, et non le catalogue de l'API distante.
- Une implémentation réelle qui gère le transport : authentification, pagination, limites de débit, timeouts, erreurs, conversion vers des objets internes.
- Une fausse implémentation déterministe pour les tests, qui reproduit les mêmes validations que la vraie et s'arrête juste avant l'appel réseau. Un faux qui accepte tout laisse passer en test ce que la production refusera.
- Un câblage par environnement — l'implémentation réelle par défaut, la fausse en test. L'application démarre et se teste sans aucun accès au système externe.
Un exemple concret
Sur les applications Symfony que je maintiens pour Orange, les échanges avec les services internes du groupe — envoi de SMS, stockage objet, jetons OAuth, référentiels — passent tous par des bridges construits sur ce modèle, mutualisés dans une librairie partagée entre cinq applications. C'est grâce à eux que l'image Docker de production peut démarrer en CI, sans réseau vers les API internes, et y dérouler une vraie suite de tests end-to-end.
Sur l'une d'elles, l'application dépend d'une API d'annuaire et de tickets qu'elle ne maîtrise pas, lente et parfois indisponible. La façade qui centralise les appels a été l'endroit naturel pour poser un cache — en distinguant ce qui peut vieillir, comme l'annuaire, de ce qui doit rester vivant, comme le statut d'un ticket —, et une dégradation gracieuse qui renvoie une valeur neutre quand l'API tombe.
Les pièges
- Laisser fuir les types externes — une méthode de la couche qui renvoie le tableau brut de l'API annule tout son intérêt.
- Y mettre de la logique métier : la couche traduit, elle ne décide pas.
- En poser partout par principe : devant une API stable et bien conçue, une traduction un pour un ajoute du code sans protéger de rien.
Une couche anti-corruption a un coût — du code de traduction à maintenir — qui se justifie quand le système externe est instable, mal conçu ou hors de votre contrôle. Face à une API maison rigide ou un legacy, c'est presque toujours rentable.
Le cas du cache derrière une façade est détaillé dans mettre une API externe en cache sans servir de données périmées. Isoler un legacy derrière une frontière propre est une étape clé de ma prestation de refonte d'application web.