feat: update xdebug setup

Setup `xdbug.client_host` to `host.docker.internal`.

See https://docs.docker.com/desktop/networking/#i-want-to-connect-from-a-container-to-a-service-on-the-host
See docker/for-linux#264

Also setup other config values which can be configured throught the
`XDEBUG_CONFIG`.

.env.dist

@@ -43,7 +43,8 @@ NODE_PORT=3505
 
 ###> Devel ###
 XDEBUG_IDEKEY=xdebug
-XDEBUG_HOST=
-XDEBUG_PORT=9000
+XDEBUG_HOST=host.docker.internal
+XDEBUG_PORT=9003
 XDEBUG_MODE=develop
+XDEBUG_LOG_LEVEL=7
 ###< Devel ###

README.md

@@ -220,8 +220,7 @@ make a [backup](#backup).
 If you want to debug a shop with [xdebug](https://xdebug.org/):
 
 - be sure you're running **dev** environment (and images),
-- setup `XDEBUG_HOST` to your local machine ip,
-- setup `XDEBUG_MODE` to `debug`,
+- add/setup `debug` to `XDEBUG_MODE`,
 - reload docker with `docker-compose up -d`.
 
 Now you're ready to remote debugging.

docker-compose.override.yml

@@ -12,10 +12,16 @@ services:
       - SYMFONY_ENV=dev
       - XDEBUG_MODE=${XDEBUG_MODE:-develop}
       - XDEBUG_CONFIG=
+        cli_color=1
         client_host=${XDEBUG_HOST}
-        client_port=${XDEBUG_PORT:-9000}
-        xdebug.start_with_request=yes
+        client_port=${XDEBUG_PORT:-9003}
+        log=/var/www/html/var/logs/xdebug.log
+        log_level=${XDEBUG_LOG_LEVEL:-7}
+        idekey=${XDEBUG_IDEKEY:-xdebug}
       - XDEBUG_SESSION=${XDEBUG_IDEKEY:-xdebug}
+    extra_hosts:
+      # Ensure that host.docker.internal is correctly defined on Linux
+      - host.docker.internal:host-gateway
 
   node:
     image: ${NODE_IMAGE}