Aller au contenu principal
Retour au blog

Configurer RTK sur Symfony : le piège du filtre Composer

RTK 1.1.0 sur Symfony : commandes couvertes, config.toml, filtre Composer à corriger et filtres vérifiés en CI. Mesures à l'appui, pertes comprises.

Flavien Métivier · 8 min de lecture
Sommaire · 7 parties

Le filtre natif composer-install de RTK passe tous ses tests. Sur mon banc, il ne réduit pourtant rien : 2 504 tokens estimés avant, 2 504 après. Composer écrit sa progression sur stderr, le filtre ne lit que stdout. Sur un composer install complet, stdout pèse 51 octets et stderr 9 964. Les tests inline ne voient pas le flux réel, donc ils restent au vert.

Une ligne fait l'essentiel de la correction : filter_stderr = true. Avec le filtre complet donné plus bas, la sortie tombe à 85 tokens. C'est le genre de réglage que l'installation par défaut ne te donne pas, et que tu ne remarques pas sans mesurer. Cet article suppose RTK déjà branché sur Claude Code, ce que couvre le guide d'installation du hook. On passe ici à la configuration pour une stack PHP/Symfony : ce que RTK couvre, ce qu'il laisse passer, ce qu'il vaut mieux lui retirer.

Conditions de mesure, valables pour tous les chiffres qui suivent : RTK 1.1.0, projet de démo généré (ni client ni production) sur dunglas/symfony-docker, PHP 8.5.12, Symfony 8.1.11, PHPUnit 13.4.6 avec 242 tests, sur amd64. Un seul run par mesure. Les tokens sont estimés en octets / 4, la méthode de RTK, et ne sont pas des tokens facturés.

Que couvre RTK dans une stack Symfony, et que laisse-t-il passer ?

La couverture se vérifie sans rien exécuter : rtk rewrite affiche la commande réécrite (code 3 ici, 0 si tes règles de permission l'autorisent), ou n'affiche rien et sort avec le code 1. Voilà ce que donne la 1.1.0 sur les outils d'un projet Symfony :

bash
rtk rewrite "vendor/bin/phpstan analyse"     # rtk phpstan analyse (code 3)
rtk rewrite "php bin/console cache:clear"   # rien (code 1)
  • Réécrits : phpunit, paratest, pest, phpstan, ecs, pint, php -l, composer install|update|require et make <cible>.
  • Non réécrits : rector, php-cs-fixer, psalm, deptrac, infection, bin/console sous toutes ses formes, composer audit|outdated et la CLI symfony.
  • Hors du hook : tout docker compose exec, quel que soit son contenu. La réponse tient dans un réglage, transparent_prefixes, avec assez de conséquences pour mériter un article à part dans cette série.

La surprise vient de PHPUnit. Lancé sans TTY, comme le fait un agent, un run vert de 242 tests ne produit que 131 tokens. Le poids est ailleurs : Composer, et des sorties qu'une option de l'outil réduit mieux que RTK.

Que régler dans config.toml pour un projet PHP ?

Le fichier est ~/.config/rtk/config.toml, et rtk config --create écrit les valeurs par défaut. Il vit au niveau de la machine, pas du projet. Quatre sections méritent un coup d'œil.

  • [retriever] : le magasin de rtk recall, qui garde la sortie complète quand un filtre élide. Par défaut mode = "sqlite", 200 entrées, 30 jours. Se change avec rtk config recall <sqlite|tee|disabled>. Ne le désactive pas : c'est ton filet.
  • [limits] : les plafonds de grep (200 résultats, 25 par fichier) et de git status. Baisse-les seulement après avoir constaté un gain, pas par principe.
  • [tracking] : l'historique de rtk gain, 90 jours par défaut.
  • [telemetry] : désactivée par défaut. Le consentement se donne à rtk init ou avec rtk telemetry enable. La documentation amont annonce un envoi par jour avec un hash d'appareil, à lire avant d'accepter sur un poste d'entreprise.

La section qui compte vraiment est [hooks]. C'est là qu'on retire à RTK ce qu'il filtre mal. Sur ma stack, deux familles de commandes : les formes de PHPUnit, et make.

bash
[hooks]
exclude_commands = ["bin/phpunit", "vendor/bin/phpunit", "./vendor/bin/phpunit", "php bin/phpunit", "make"]

Un avertissement avant de toucher au hook : rtk init -g écrit dans CLAUDE_CONFIG_DIR s'il est défini, pas dans $HOME. En préparant cet article avec un HOME jetable, j'ai modifié mon vrai settings.json de Claude Code. La sauvegarde .bak créée par RTK m'a permis de restaurer. Lance d'abord rtk init -g --dry-run.

Pourquoi exclure PHPUnit et make de la réécriture ?

Parce qu'une compression qui masque un échec coûte plus qu'elle ne rapporte. Avec deux tests rouges, rtk phpunit ramène la sortie de 265 à 89 tokens, mais le filtre coupe après --- Expected sur un assertSame de chaînes : le fichier et la ligne du second test disparaissent. Au vert, on gagne 121 tokens. Le rapport est mauvais.

Je l'ai vérifié en session réelle avec claude -p sur Haiku 5.5, une session par cas, pour contrôler le fonctionnement et non le coût. Avec le filtre, l'agent répond « fichier:ligne non affiché (sortie tronquée…) ». PHPUnit exclu, il donne les deux emplacements. Le gain n'est pas assez élevé pour imposer un aller-retour de plus, surtout quand la boucle de vérification de l'agent repose sur ces tests.

Pour make, le filtre natif applique max_lines = 50 et garde le début. PHPStan passe de 11 622 à 1 048 tokens, avec « 523 lines truncated » ; Rector de 8 363 à 368, diffs perdus. Le code de sortie et l'indice recall restent, mais le résumé de fin saute. Si ton équipe lance tout par Makefile, exclure make est le choix prudent.

Votre équipe utilise Claude Code ?

Formation intra sur vos projets réels : de la demi-journée à 2 jours, 6 devs max.

Voir les formats →

Comment corriger le filtre Composer avec un fichier projet ?

En le redéfinissant dans .rtk/filters.toml, versionné avec le dépôt. La résolution passe par ce fichier, puis par ~/.config/rtk/filters.toml, puis par les filtres intégrés. Dans mes tests, cette version projet approuvée prend bien le pas sur le filtre natif du même nom.

bash
schema_version = 1

# Composer écrit la progression sur stderr : sans filter_stderr, le filtre natif ne voit rien.
[filters.composer-install]
description = "composer install/update/require, stderr compris"
match_command = "^composer\\s+(install|update|require)\\b"
filter_stderr = true
strip_ansi = true
strip_lines_matching = [
  "^\\s*$",
  "^  - (Downloading|Installing|Locking|Upgrading|Downgrading|Removing) ",
  "^Loading composer",
  "^Updating dependencies",
  "^Use the `composer fund`",
  "packages you are using are looking for funding",
]
max_lines = 40

[[tests.composer-install]]
name = "retire la progression, garde le résumé"
input = "Package operations: 1 install, 0 updates, 0 removals\n  - Downloading a/b (1.0.0)\n  - Installing a/b (1.0.0): Extracting archive\nGenerating autoload files\n"
expected = "Package operations: 1 install, 0 updates, 0 removals\nGenerating autoload files"

[[tests.composer-install]]
name = "garde une erreur de résolution"
input = "Your requirements could not be resolved to an installable set of packages.\n\n  Problem 1\n    - a/b 1.0 requires php ^9.0\n"
expected = "Your requirements could not be resolved to an installable set of packages.\n  Problem 1\n    - a/b 1.0 requires php ^9.0"
  • composer install complet, cache plein : 2 504 tokens en brut, 2 504 avec le filtre natif, 85 avec celui-ci.
  • Rien à installer : de 106 à 80 tokens.
  • composer require sur un paquet inexistant : de 258 à 248 tokens, erreur conservée, code de sortie 2.

Les autres clés se combinent dans un ordre fixe : strip_ansi, replace, match_output, strip_lines_matching ou keep_lines_matching, truncate_lines_at, tail_lines, max_lines, on_empty. Pense à cet ordre avant de plafonner : un max_lines garde le début, souvent la partie la moins utile d'une sortie de build.

Comment approuver et tester ces filtres en CI ?

Un filtre projet n'est appliqué qu'après approbation explicite : rtk trust enregistre l'empreinte SHA-256 du fichier, et toute modification demande de recommencer. C'est voulu, car un dépôt cloné ne doit pas pouvoir réécrire ce que lit ton agent à ton insu. Relis donc le fichier avant d'approuver. Comme RTK tourne dans le conteneur sur cette stack, les commandes passent par lui :

bash
docker compose exec -T php rtk trust -y
docker compose exec -T php rtk verify --require-all   # 153/153 sur mon banc

--require-all échoue si un filtre n'a aucun test inline : ajoute-le en CI. Mais souviens-toi du point de départ : ces tests valident une chaîne d'entrée, pas le flux réel. Le filtre natif de Composer les passe et ne filtre rien. Complète donc par une mesure en octets sur la vraie commande, stdout et stderr confondus, comme le détaille la méthode de mesure par tâche.

Pourquoi un filtre custom ne couvre-t-il pas Rector ni la console ?

Parce qu'il ne déclenche pas la réécriture. Un filtre approuvé sur ^bin/console\s+cache: laisse rtk rewrite sans réponse, code 1, ce que rejoint l'issue amont #2268. La documentation amont laisse entendre que la réécriture lit tes filtres, mais ce n'est pas ce que j'observe en 1.1.0 : ton filtre reste inactif pour l'agent, sauf sur une commande déjà réécrite, comme composer install.

Tant mieux, en un sens : l'option native de l'outil fait mieux, ne perd que ce que tu choisis, et ne dépend d'aucun filtre. Ces commandes ne passent pas par RTK, à toi de les écrire dans le CLAUDE.md du projet pour que l'agent les emploie :

  • Rector --dry-run sur 25 fichiers : 8 332 tokens, 21 avec --no-diffs. Lance sans diff pour savoir si quelque chose change, puis avec diff sur le fichier concerné.
  • PHP-CS-Fixer --dry-run --diff : 6 341 tokens, 414 sans --diff.
  • Psalm : 1 844 tokens, 803 avec --output-format=compact.
  • debug:container : 20 447 tokens, 837 en ciblant un service, avec debug:container router.
  • composer audit : 4 059 tokens pour 15 avis, 30 avec --format=summary. Ce dernier masque les avis : réserve-le au contrôle rapide, jamais à la décision de sécurité.
  • PHPUnit : évite --testdox pour l'agent, 3 746 tokens au vert contre 131.

Que faire de cette configuration dès maintenant ?

Ces gains portent sur des octets de sortie shell. Ils ne promettent rien sur ta facture, et un filtre qui force l'agent à relancer une commande peut coûter davantage qu'il n'économise. Mesure sur ton projet avant de généraliser, car ces chiffres viennent d'un projet de démo :

  • Compare composer install brut et filtré sur ton dépôt, stderr compris.
  • Passe tes outils à rtk rewrite pour savoir lesquels sont vraiment couverts.
  • Exclus PHPUnit et, si tu passes par un Makefile, make.
  • Versionne .rtk/filters.toml, approuve-le et ajoute rtk verify --require-all à la CI.
  • Inscris les options natives de Rector, Psalm et PHP-CS-Fixer dans ton CLAUDE.md.

Si ton équipe veut régler Claude Code sur ses propres projets plutôt que sur une démo, la formation intra part de ce type de mesure.

Cet article vous a été utile ? Partagez-le.

Portrait de Flavien Métivier, fondateur de The Bearded Bear : barbe longue, lunettes, sur fond sombre

Écrit par

Flavien Métivier

Expert PHP/Symfony indépendant depuis 2014, ancien CTO de Kartable et d'Extrabat. Plus de 80 projets menés, de l'audit à la migration.

Mon parcours

À lire ensuite

Votre équipe utilise Claude Code ?

Formation intra sur vos projets réels : de la demi-journée à 2 jours, 6 devs max.

Newsletter Bear Bytes

Veille Claude Code, Symfony et PHP, retours d'expérience terrain et conseils techniques, directement dans votre boîte mail.