From 39bc19e183c12163e587750809c867ca441f4549 Mon Sep 17 00:00:00 2001
From: Jose Carlos <josecarlospeer@gmail.com>
Date: Fri, 20 Feb 2026 23:05:30 +0100
Subject: [PATCH] fix: update Xdebug config to Xdebug 3 format across dev
 images

- Add xdebug.client_port=9003 (Xdebug 3 default, was implicit)
- Change start_with_request: yes -> trigger (explicit activation required)
- Add develop mode alongside debug (enables var_dump improvements etc.)
- Increase max_nesting_level: 250 -> 512
Source: https://xdebug.org/docs/all_settings
---
 8.1/devfs/etc/php81/conf.d/00_xdebug.ini | 13 ++++++++-----
 8.2/devfs/etc/php82/conf.d/00_xdebug.ini | 13 ++++++++-----
 8.3/devfs/etc/php83/conf.d/00_xdebug.ini | 13 ++++++++-----
 3 files changed, 24 insertions(+), 15 deletions(-)

diff --git a/8.1/devfs/etc/php81/conf.d/00_xdebug.ini b/8.1/devfs/etc/php81/conf.d/00_xdebug.ini
index c177230..1703267 100644
--- a/8.1/devfs/etc/php81/conf.d/00_xdebug.ini
+++ b/8.1/devfs/etc/php81/conf.d/00_xdebug.ini
@@ -1,11 +1,14 @@
+; Source: https://xdebug.org/docs/all_settings
 zend_extension=xdebug.so
 
-xdebug.mode=debug
-xdebug.log_level=0
-
-xdebug.start_with_request=yes
+xdebug.mode=debug,develop
+; Override via XDEBUG_CONFIG env: "client_host=<your-ip>"
+; Or set XDEBUG_CLIENT_HOST at container runtime
 xdebug.client_host=${XDEBUG_CLIENT_HOST}
-xdebug.max_nesting_level=250
+xdebug.client_port=9003
+xdebug.start_with_request=trigger
+xdebug.log_level=0
 
+xdebug.max_nesting_level=512
 xdebug.var_display_max_data=10000
 xdebug.var_display_max_depth=20
diff --git a/8.2/devfs/etc/php82/conf.d/00_xdebug.ini b/8.2/devfs/etc/php82/conf.d/00_xdebug.ini
index c177230..1703267 100644
--- a/8.2/devfs/etc/php82/conf.d/00_xdebug.ini
+++ b/8.2/devfs/etc/php82/conf.d/00_xdebug.ini
@@ -1,11 +1,14 @@
+; Source: https://xdebug.org/docs/all_settings
 zend_extension=xdebug.so
 
-xdebug.mode=debug
-xdebug.log_level=0
-
-xdebug.start_with_request=yes
+xdebug.mode=debug,develop
+; Override via XDEBUG_CONFIG env: "client_host=<your-ip>"
+; Or set XDEBUG_CLIENT_HOST at container runtime
 xdebug.client_host=${XDEBUG_CLIENT_HOST}
-xdebug.max_nesting_level=250
+xdebug.client_port=9003
+xdebug.start_with_request=trigger
+xdebug.log_level=0
 
+xdebug.max_nesting_level=512
 xdebug.var_display_max_data=10000
 xdebug.var_display_max_depth=20
diff --git a/8.3/devfs/etc/php83/conf.d/00_xdebug.ini b/8.3/devfs/etc/php83/conf.d/00_xdebug.ini
index c177230..1703267 100644
--- a/8.3/devfs/etc/php83/conf.d/00_xdebug.ini
+++ b/8.3/devfs/etc/php83/conf.d/00_xdebug.ini
@@ -1,11 +1,14 @@
+; Source: https://xdebug.org/docs/all_settings
 zend_extension=xdebug.so
 
-xdebug.mode=debug
-xdebug.log_level=0
-
-xdebug.start_with_request=yes
+xdebug.mode=debug,develop
+; Override via XDEBUG_CONFIG env: "client_host=<your-ip>"
+; Or set XDEBUG_CLIENT_HOST at container runtime
 xdebug.client_host=${XDEBUG_CLIENT_HOST}
-xdebug.max_nesting_level=250
+xdebug.client_port=9003
+xdebug.start_with_request=trigger
+xdebug.log_level=0
 
+xdebug.max_nesting_level=512
 xdebug.var_display_max_data=10000
 xdebug.var_display_max_depth=20