PrestaShop en anglais au lieu du français : quand le .gitignore vide l’image

Par Maxime Bénard

9 min de lecture

Couverture d’article Mintfull : « Sort by, Home : le .gitignore avait gardé le français hors de l’image », git check-ignore qui désigne la règle /translations/*-*/ de la ligne 139

Recette d’une préproduction montée sur un socle PrestaShop 9.2 en pré-version, page catégorie : le tri affiche « Sort by », la première option est « Relevance », le fil d’Ariane dit « Home », les filtres et le prix sont en anglais. La langue française est installée et active, le build est vert, le déploiement n’a levé aucune erreur. Et une partie des textes est bien en français, ce qui rend le tableau encore plus trompeur. Rien ne plante, tout est simplement en anglais là où ça ne devrait pas l’être.

Si votre PrestaShop s’affiche en anglais au lieu du français alors que la langue est active, la réponse courte est souvent celle-ci : les catalogues XLIFF de translations/fr-FR/ ne sont pas dans l’image qui tourne. Chez nous, une règle du .gitignore les tenait hors du dépôt, donc hors du build.

Ce n’est pas le client qui l’a signalé : on l’a relevé nous-mêmes, en recettant une autre évolution sur cette préproduction. En local, tout s’affichait en français. Et comme cette préprod n’avait pas été recettée depuis longtemps, le trou a été vu environ une dizaine de jours après le déploiement qui l’avait ouvert.

Pourquoi PrestaShop reste en anglais malgré 53 chaînes françaises en base

Sur ce projet, des scripts injectent nos propres libellés dans la table ps_translation. En préprod, on trouvait 53 chaînes françaises, bien rattachées à la bonne langue, et c’étaient les seules à s’afficher en français sur le front.

Une page à moitié traduite pourrait faire penser à un cache mal vidé. Mais l’anglais ne tombait pas au hasard : il couvrait des éléments précis, des blocs entiers (le tri, le fil d’Ariane, les filtres), pendant que nos libellés restaient en français. Un cache ne découpe pas une page de cette façon. Des blocs entiers en anglais, c’est la signature d’un catalogue qui manque, et c’est de ce côté qu’on a cherché directement.

Or la table n’est qu’une couche de surcharge. SqlTranslationLoader (src/PrestaShopBundle/Translation/Loader/SqlTranslationLoader.php, vérifié sur les tags 9.1.5 et 9.2.0-rc.1) lit key, translation et domain dans ps_translation et les pose par-dessus les catalogues XLIFF. Sans catalogue fichier, tout ce qui n’est pas surchargé retombe sur la chaîne source, et les chaînes sources du core sont en anglais. Sur 9.x, le lien est même mécanique : PrestaShopBundle\Translation\Translator::addResource() ajoute une ressource db à chaque fichier XLIFF enregistré, pour le même domaine et la même locale. Un domaine sans fichier fr-FR ne charge donc pas non plus ses lignes de ps_translation. C’est ce qui explique nos 53 chaînes : elles appartenaient toutes à des domaines de modules qui livrent leur propre XLIFF fr-FR, et ces fichiers-là étaient bien dans l’image.

Comment vérifier si votre image contient le pack de langue fr-FR

La méthode qui a débloqué la situation : vérifier à chaque couche ce qui est réellement présent, pas ce qui est configuré. Trois commandes suffisent pour savoir si vous êtes concerné.

La base. Ce qui est surchargé, par langue :

sql
SELECT l.locale, COUNT(*) AS nb
FROM ps_translation t
JOIN ps_lang l ON l.id_lang = t.id_lang
GROUP BY l.locale;

53 lignes pour fr-FR. C’est, au mieux, tout ce qui peut s’afficher en français sans catalogue.

Le conteneur. Le core cherche les catalogues dans translations/ à la racine (_PS_TRANSLATIONS_DIR_ dans config/defines.inc.php, SF_TRANSLATIONS_DIR dans classes/Language.php). Chez nous le code vit dans /app :

bash
$ ls /app/translations
cldr  default

Pas de fr-FR/. Donc pas de ShopThemeCatalog.fr-FR.xlf, pas de « Pertinence », pas de « Trier par : ».

L’image. Reste à savoir où le dossier disparaît. On liste l’image elle-même, sans aucun volume monté :

bash
docker run --rm --entrypoint ls "$IMAGE" /app/translations

Même résultat. Le dossier n’a jamais été dans l’image, il n’a pas été écrasé au runtime : le problème est dans ce que le build reçoit du dépôt. Chez nous, l’image est construite en CI par Kaniko avec le checkout Git comme contexte, puis un COPY --chown=app:app . . : ce que Git ignore n’existe tout simplement pas pour le build.

La cause : une règle translations/*-*/ dans le .gitignore

Une ligne du .gitignore du projet :

gitignore
/translations/*-*/

Le motif attrape tout dossier de premier niveau de translations/ dont le nom contient un tiret, donc fr-FR/ et n’importe quelle autre locale. Le slash final le limite aux dossiers : les archives de cache sf-fr-FR.zip que PrestaShop dépose au même endroit quand il télécharge un pack (Language::getPathToCachedTranslationPack() construit ce nom à partir du type sf et de la locale, dans _PS_TRANSLATIONS_DIR_) ne sont pas concernées. cldr et default n’ont pas de tiret, ils passent. git check-ignore désigne la règle coupable en une commande :

bash
$ git check-ignore -v translations/fr-FR/ShopThemeCatalog.fr-FR.xlf
.gitignore:139:/translations/*-*/   translations/fr-FR/ShopThemeCatalog.fr-FR.xlf

Ligne 139 d’un .gitignore de plus de 140 lignes, écrit au démarrage du projet pour ne pas versionner tout ce que l’installation génère. La règle était raisonnable ce jour-là : les packs de langue se retéléchargent. Personne ne l’a relue quand l’image est devenue le seul moyen de livrer.

Le pack existait sur les postes de développement : il avait été téléchargé en local environ deux mois avant le constat, puis jamais commité, puisque Git ne le voyait pas. La CI, elle, part d’un checkout propre.

Vérifié sur les tags 9.1.5 et 9.2.0-rc.1 du dépôt officiel (lignes 174 et 175) : le .gitignore de PrestaShop ne contient pas translations/*-*/, mais translations/* suivi de !translations/default. La règle à tiret est propre à notre projet, mais la règle officielle produit le même effet : un dépôt bâti sur celui de PrestaShop n’embarque aucun pack de langue.

Ces packs ne sont d’ailleurs pas dans le dépôt du core (sous translations/, il ne contient que cldr/, default/, export/ et un index.php). Dans classes/Language.php, Language::downloadXLFLanguagePack() les télécharge depuis l’URL de la constante SF_LANGUAGE_PACK_URL, https://i18n.prestashop-project.org/translations/%version%/%locale%/%locale%.zip, puis installSfLanguagePack() les extrait dans translations/.

Le correctif : versionner le pack fr-FR avec une exception dans le .gitignore

Deux options : télécharger le pack pendant le build, ou le versionner. On l’a versionné :

gitignore
/translations/*-*/
!/translations/fr-FR/

L’exception fonctionne parce que c’est le dossier fr-FR lui-même que le motif exclut, pas son parent : Git ne peut pas réinclure un fichier dont le dossier parent est ignoré, mais il peut réinclure le dossier. Si votre dépôt reprend la règle officielle translations/*, la même ligne !translations/fr-FR/ sous !translations/default suffit (testé avec git add sur un dépôt vide).

Avant de commiter, relancez git check-ignore -v sur un fichier du pack : sans sortie et avec un code retour 1, il n’est plus ignoré.

Pour récupérer le pack sans passer par le back-office :

bash
curl -sSfo /tmp/fr-FR.zip \
  https://i18n.prestashop-project.org/translations/9.2.0/fr-FR/fr-FR.zip
unzip -o /tmp/fr-FR.zip -d translations/
ls translations/fr-FR/*.xlf | wc -l   # 169

169 fichiers XLIFF, environ 2,8 Mo décompressés (vérifié le 23/09/2026 sur l’archive servie pour 9.2.0). Le pack que nous avons commité, un pack 9.2 téléchargé en local depuis cette même URL, compte lui aussi 169 catalogues, pour 3,1 Mo dans le dépôt.

Le compromis est assumé : environ 3 Mo de plus dans le dépôt et un pack à renouveler à chaque montée de version, contre une image autonome, sans dépendance réseau au build ni script à rejouer après déploiement.

Un détail relevé en vérifiant, qui conforte ce choix : au 23/09/2026, le serveur i18n renvoie le même fichier (même empreinte MD5) pour 9.0.0, 9.1.5 et 9.2.0, et répond 200 même pour un numéro de version qui n’existe pas (9.9.9, 9.2.7), alors que 9.2.0-rc.1 renvoie 404. La version dans l’URL ne suffit donc pas à tracer ce qu’on a récupéré. Un pack commité et daté, si.

Le réflexe à retenir

Langue active mais textes natifs en anglais : ne regardez pas la configuration, listez translations/ dans l’image livrée.

Des chaînes françaises en base ne prouvent rien sur les catalogues fichiers. Des blocs entiers en anglais désignent un fichier manquant, pas un cache. Descendez couche par couche (base, conteneur, image sans volume, dépôt) et arrêtez-vous à la première où le fichier manque. git check-ignore -v donne ensuite la règle fautive.

Valider la traduction en recette, puis bloquer la régression en CI

La validation se fait sur une page catégorie, qui concentre des chaînes de plusieurs domaines : le tri (« Trier par : », « Pertinence », « Prix, croissant »), « Accueil » dans le fil d’Ariane, les filtres (« Filtrer par », « Filtres actifs », « Effacer tout »), le libellé « Prix » de la recherche à facettes, puis une catégorie vide, qui doit afficher « Restez à l’écoute ! » et « Retour à la page d’accueil ». Les chaînes du tri, du fil d’Ariane et des filtres sont dans le pack officiel, réparties entre ShopThemeCatalog, ShopThemeGlobal, ShopThemeActions et ModulesFacetedsearchShop.

Une recette manuelle ne protège pas de la prochaine régression. Le vrai garde-fou est un contrôle après le build de l’image, par exemple :

bash
docker run --rm --entrypoint sh "$IMAGE" -c '
  test -f /app/translations/fr-FR/ShopThemeCatalog.fr-FR.xlf || exit 1
  n=$(ls /app/translations/fr-FR/*.xlf | wc -l)
  [ "$n" -ge 169 ] || { echo "pack fr-FR incomplet: $n fichiers"; exit 1; }
'

Honnêtement : ce contrôle n’est pas encore dans notre CI. Le correctif a remis le pack dans l’image, le garde-fou automatique reste à brancher. C’est la ligne qui aurait transformé une préprod à moitié en anglais en un pipeline rouge, dès le premier build, plutôt qu’en constat une dizaine de jours plus tard.

Deux précautions pour la suite :

  • Préprod et prod peuvent être construites par des chemins différents. Une image corrigée en préprod ne dit rien de celle de prod si elle sort d’un autre job ou d’une autre branche : on vérifie les deux. Sur ce projet, le risque était noté dès le ticket : même construction, même trou en prod. L’image de prod a donc été vérifiée à son tour après le correctif. C’est le même écart entre ce qu’on croit livrer et ce qui tourne que dans les erreurs classiques d’une migration PrestaShop sur Kubernetes.
  • La correspondance version du core et pack se documente. Une ligne dans le README (pack fr-FR récupéré le JJ/MM/AAAA pour PrestaShop 9.2.0) et une case dans la checklist de montée de version, à côté des points listés pour anticiper PrestaShop 9.

Un build vert ne dit pas ce que contient l’image

Sur une boutique PrestaShop conteneurisée, le pack de langue est un fichier comme un autre : il peut disparaître en silence entre le poste du développeur et le registre, sans une ligne de log. Ce contrôle rejoint ceux qu’on applique déjà au contenu de nos images, comme l’installation déclarative des modules, et les autres surprises de la version sont relevées dans PrestaShop 9.2 vu depuis nos projets.

Si vos montées de version PrestaShop passent par Docker ou Kubernetes et que ce genre d’écart vous parle, c’est le type de chantier que nous reprenons.

Partager cet article
Articles

Des articles pour faire pousser vos idées

D'autres retours d'expérience et méthodes à mettre en pratique sur votre site.

Bon, on en discute ?

Demandez votre diagnostic de performance gratuit : un échange de 30 minutes, vos Core Web Vitals relevés sur mobile et une synthèse écrite de ce qui mérite d’être corrigé en premier.

Discuter de mes besoins