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