Error Xdebug: [Config] The setting 'xdebug.remote_connect_back' has been renamed, see the upgrading guide at
Error en xdebug por cambio en variable de configuración en archivo .ini
Un poco de contexto. Mi configuración
- Versión de Xdebug: 3.1.1
- Version PHP: PHP 8.0.12 (cli)
- Docker version 20.10.8, build 3967b7d
El error se presentaba cada vez que ejecutaba un archivo .php por consola dentro de un contenedor con fpm.
Si bien, no era un problema bloqueante porque el script terminaba ejecutando y los puntos de interrupción los respetaba era un poco molesto ya que con cada ejecución aparecía por pantalla.
Configuración Xdebug en docker (xdebug.ini)
Este archivo en el contenedor de Docker se encuentra en:/usr/local/etc/php/conf.d/xdebug.ini
Su contenido era el siguiente:
# configuración con error
xdebug.mode=debug
xdebug.remote_enable=1
xdebug.client_host=host.docker.internal
xdebug.client_port=9005
xdebug.remote_connect_back=0
xdebug.start_with_request=yes
La solución
Después de leer un poco y tantear otras configuraciones, sin éxito, era suficiente con quitar las dos líneas del mensaje y reconstruir el contenedor.
xdebug.mode=debug
xdebug.client_host=host.docker.internal
xdebug.client_port=9005
xdebug.start_with_request=yes
En mi caso para reconstruir el contenedor ejecuto la siguiente linea:
docker-compose --env-file ./docker/.env up -d --no-deps --force-recreate --build nombre-del-servico-en-docker-compose-yml
Nota final
Como nota final dejo la configuración que tengo en docker-compose relacionada con Xdebug y unas imágenes de las preferencias de phpstorm
build:
context: docker/fpm
environment:
PHP_IDE_CONFIG: serverName=ServXdebug
PHP_XDEBUG_ENABLED: 1
XDEBUG_CONFIG: client_host=host.docker.internal client_port=9005
volumes:
- ./docker/fpm/xdebug.ini:/usr/local/etc/php/conf.d/xdebug.ini
Autor: Eduardo A. F.
Publicado: 01-11-2021 15:49