Changeset 61541

Timestamp:

01/28/2026 12:43:01 AM (5 months ago)

Author:

wildworks

Message:

Build/Test Tools: Improve Xdebug cross-platform compatibility.

Updates the Xdebug configuration in the local Docker environment to better support Windows (WSL2) users while maintaining stability for macOS and Linux.

• Enables xdebug.discover_client_host to allow Xdebug to automatically connect back to the IP address listed in the HTTP request headers, ensuring the debugger works reliably regardless of specific network topology.
• Sets xdebug.client_host to host.docker.internal as a fallback for xdebug.discover_client_host. In WSL2 networking, localhost resolves to the container itself rather than the host machine, preventing the debugger from connecting to the IDE; host.docker.internal correctly routes to the host machine across platforms.

Follow-up to [60060].

Reviewed-by wildworks.
Merges [61461] to the 6.9 branch.

Props SirLouen, jdeep, westonruter.
See #49953.
Fixes #63979.

Location:

branches/6.9

Files:

• . (modified) (1 prop)
• tools/local-env/php-config.ini (modified) (1 diff)

branches/6.9/tools/local-env/php-config.ini

@@ -4 +4 @@
 post_max_size = 1G
 xdebug.start_with_request=trigger
+xdebug.discover_client_host=true
+xdebug.client_host=host.docker.internal