Modifier le code de MyClub : les bonnes pratiques à respecter

Créé par Jean-Emmanuel Bissey le 29/08/2026 Publié

Dans un précédent article, nous avons vu comment mettre en place l'environnement nécessaire pour travailler sur le code de MyClub.

Maintenant que l'environnement de développement est opérationnel, une question importante se pose :

Comment modifier le code de MyClub sans dégrader sa qualité ?

Les 2 outils essentiels

Outil Rôle
PHPCBF / PHPCS Vérifie et corrige automatiquement le formatage du code (indentation, espaces, accolades, etc.)
PHPStan Analyse statique du code PHP sans l'exécuter : détecte les erreurs de typage, appels de méthodes inexistantes, valeurs null, etc.

Les commandes à lancer

cd ~/Clones/GitHub/MyClub/WebSite
vendor/bin/phpcbf           # corrige le formatage
vendor/bin/phpstan analyse  # analyse le code
Résultats attendus : No fixable errors were found puis [OK] No errors.

Bonnes pratiques

  • Ne jamais masquer une erreur PHPStan — corriger la cause réelle, pas le symptôme.
  • Typer strictement — MyClub utilise declare(strict_types=1) ; toujours typer méthodes et propriétés.
  • Commits ciblés — une modification = un objectif clair. Éviter de mélanger correction fonctionnelle, refactorisation et reformatage.
  • Vérifier régulièrement — pas à la fin d'une grosse fonctionnalité, mais à chaque petite étape.
  • Ne pas oublier les tests — un code propre et sans erreur PHPStan peut quand même contenir des bugs métier.

La règle simple à retenir

Avant de valider une modification :
  • ✅ Code correctement formaté
  • ✅ PHPStan sans erreur
  • ✅ Tests qui passent
  • ✅ Modification limitée à ce qui est nécessaire
  • ✅ Commit clair et cohérent
L'objectif n'est pas d'écrire du code parfait, mais que chaque modification laisse le projet au moins aussi propre qu'avant.