Así es como configuré recientemente docker + php + xdebug para servicios http. Guié a mis compañeros a través de él y funcionó a la perfección.

1. Agregue ENV PHP_IDE_CONFIG a la configuración de su grupo docker fpm

Debe agregar este entorno a la configuración de su grupo php-fpm. Podría ser www.conf (como ejemplo)

 env[PHP_IDE_CONFIG] = "serverName=localhost"

2. Agregue xdebug.ini a su contenedor docker

Aquí hay un ejemplo de xdebug.ini que usé para la configuración:

 xdebug.remote_enable = 1 xdebug.remote_autostart = 1 xdebug.remote_connect_back = off xdebug.remote_host = host.docker.internal xdebug.remote_port = 9000 xdebug.idekey = PHPSTORM xdebug.max_nesting_level = 1500

3. [IntelliJ IDEA o PHPStorm] - Configuración de servidores PHP

1. Preferences abiertas
2. Vaya a Languages & Frameworks -> PHP -> Servers
3. Establezca el nombre en localhost (es importante y debe coincidir con el valor PHP_IDE_CONFIG )
4. Establecer host en localhost
5. Habilitar use path mappings
6. Asigne la ruta raíz de su proyecto al directorio de trabajo de la ventana acoplable (por ejemplo /var/www/html ) para que IntelliJ pueda asignar correctamente las rutas.

4. [IntelliJ IDEA o PHPStorm] - Configurar clave IDE

1. Preferences abiertas
2. Vaya a Languages & Frameworks -> PHP -> Debug -> DGBp proxy
3. Establezca la clave IDE en PHPSTORM

5. Agregue XDEBUG_SESSION=PHPSTORM a su url/cookie.

Por fin:

• agregue un ?XDEBUG_SESSION=PHPSTORM a su URL O
• agregue una cookie con el nombre XDBEUG_SESSION y el valor PHPSTORM

El problema estaba en: entorno:

 - XDEBUG_CONFIG:remote_host=host.docker.internal remote_enable=1 remote_autostart=off xdebug.idekey=PHPSTORM

1. no está correctamente analizado.
2. si paso solo remote_host=host.docker.internal, pasará "localhost" en lugar de la dirección IP del host.

Sé que la publicación es para usuarios de PHPStorm, pero si algún usuario de VSCode se encuentra aquí, hay dos cosas que deben hacerse de manera diferente a PHPStorm (más en esta respuesta para PHPStorm https://stackoverflow.com/a/61561910/3056278 ) -

1. Pase la dirección IP de su host (192.168...) en lugar de host.docker.internal
2. Configure pathMappings en su configuración de lanzamiento de depuración -

 { "name": "Debug Docker", "type": "php", "request": "launch", "port": 9000, "pathMappings": { "/var/www/app": "${workspaceFolder}" } },

¡Reemplace /var/www/app con su propia ruta!