From 8983ddb944d68ac22094261a894916715a1f761f Mon Sep 17 00:00:00 2001
From: Jacques Bodin-Hullin <j.bodinhullin@monsieurbiz.com>
Date: Fri, 16 Jan 2026 12:00:13 +0100
Subject: [PATCH] =?UTF-8?q?feat(dev):=20ajout=20du=20support=20Symfony=20C?=
 =?UTF-8?q?LI=20pour=20l'ex=C3=A9cution=20PHP=20locale?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Ajout du fichier .php-version (8.2) pour Symfony CLI
- Makefile : détection automatique du binaire symfony et création des
  wrappers PHP_HOST/COMPOSER_HOST pour les commandes hôte
- README : documentation de la configuration PHP locale via Symfony CLI
---
 .php-version |  1 +
 Makefile     | 11 +++++++----
 README.md    |  6 ++++++
 3 files changed, 14 insertions(+), 4 deletions(-)
 create mode 100644 .php-version

diff --git a/.php-version b/.php-version
new file mode 100644
index 000000000..2983cad04
--- /dev/null
+++ b/.php-version
@@ -0,0 +1 @@
+8.2
diff --git a/Makefile b/Makefile
index efb9984ef..d1bf2b574 100644
--- a/Makefile
+++ b/Makefile
@@ -5,6 +5,9 @@ default: help
 CURRENT_UID ?= $(shell id -u)
 DOCKER_UP_OPTIONS ?= --detach
 DOCKER_COMPOSE_BIN ?= docker compose
+SYMFONY_BIN := $(shell command -v symfony 2>/dev/null)
+PHP_HOST    = $(if $(SYMFONY_BIN),$(SYMFONY_BIN) php,php)
+COMPOSER_HOST = $(if $(SYMFONY_BIN),$(SYMFONY_BIN) composer,composer)
 
 # Exécutables
 DOCKER_COMP = CURRENT_UID=$(CURRENT_UID) $(DOCKER_COMPOSE_BIN)
@@ -163,7 +166,7 @@ compose.override.yml:
 vendors: vendor node_modules
 
 vendor: composer.lock
-	composer install --no-scripts
+	$(COMPOSER_HOST) install --no-scripts
 
 node_modules:
 	npm install --legacy-peer-deps
@@ -192,10 +195,10 @@ reset-db:
 	echo 'CREATE DATABASE web' | $(DOCKER_COMPOSE_BIN) run -T --rm db /opt/mysql_no_db
 
 db-migrations:
-	php bin/phinx migrate
+	$(PHP_HOST) bin/phinx migrate
 
 db-seed:
-	php bin/phinx seed:run
+	$(PHP_HOST) bin/phinx seed:run
 
 clean-test-deprecated-log:
 	rm -f var/logs/test.deprecations.log
@@ -204,4 +207,4 @@ var/logs/test.deprecations_grouped.log:
 	cat var/logs/test.deprecations.log | cut -d "]" -f 2 | awk '{$$1=$$1};1' | sort | uniq -c | sort -nr > var/logs/test.deprecations_grouped.log
 
 var/cache/dev/AppKernelDevDebugContainer.xml:
-	php bin/console cache:warmup --env=dev
+	$(PHP_HOST) bin/console cache:warmup --env=dev
diff --git a/README.md b/README.md
index ad1ac870c..a67146fcc 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,12 @@ Code source pour le site [afup.org](https://afup.org).
 
 Retrouvez la documentation pour le setup de l'environnement de dev dans la [documentation dédiée](./doc/dev-setup.md).
 
+### PHP local via Symfony CLI
+
+- Un fichier `.php-version` existe à la racine avec `8.2` pour que la Symfony CLI sélectionne PHP 8.2 localement. Ce fichier devra être mis à jour lors des bump de la version de PHP.
+- Le Makefile détecte automatiquement `symfony` : s'il est présent, les commandes locales passent par `symfony php` et `symfony composer`; sinon il conserve `php` et `composer` du système.
+- Les commandes Docker restent inchangées (le PHP du conteneur est utilisé).
+
 ## Contribution
 
 Toute contribution est la bienvenue, vous trouverez les informations dans le fichier [CONTRIBUTING.md](./CONTRIBUTING.md).