Error Xdebug: [Config] The setting 'xdebug.remote_connect_back' has been renamed, see the upgrading guide at

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

Ejecución exitosa script php por consola con xdebug Ejecución exitosa script php por consola con xdebug en phpstorm

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
Configuración Xdebug en phpstorm sección Servers
Configuración Xdebug en phpstorm sección Servers
Configuración Xdebug en phpstorm sección Debug
Configuración Xdebug en phpstorm sección Debug

Autor: Eduardo A. F.
Publicado: 01-11-2021 15:49