Depurar PHP servidor web en Docker con VScode debug

La configuración de Xdebug en el contenedor Docker puede realizarse en el archivo Dockerfile o en el archivo docker-compose.yml, dependiendo de cómo esté estructurado tu entorno de desarrollo. Te proporcionaré los pasos para ambos casos:

Configuración en Dockerfile:

1. Abre tu archivo Dockerfile.
2. Asegúrate de tener el paquete Xdebug instalado en el contenedor. Puedes usar el siguiente comando en el archivo Dockerfile:

   RUN apt-get update && apt-get install -y php-xdebug

3. Busca la sección de configuración de PHP (php.ini) en el archivo Dockerfile y realiza los cambios necesarios para activar Xdebug:

   RUN echo "xdebug.remote_enable=1" >> /path/to/php.ini
   RUN echo "xdebug.remote_autostart=1" >> /path/to/php.ini

Reemplaza /path/to/php.ini con la ubicación real de tu archivo php.ini.

Configuración en docker-compose.yml:

1. Abre tu archivo docker-compose.yml.
2. Agrega el servicio para PHP y configura los volúmenes y la configuración de Xdebug. Asegúrate de que el servicio tenga acceso a la red del contenedor y al puerto 9000:

   services:
     php:
       build:
         context: .
         dockerfile: Dockerfile
       volumes:
         - ./path/to/php.ini:/path/to/php.ini
       ports:
         - 9000:9000
       networks:
         - mynetwork
   networks:
     mynetwork:

Reemplaza /path/to/php.ini con la ubicación real de tu archivo php.ini.

3. Asegúrate de que el archivo php.ini esté presente en la ubicación especificada en el volumen.

Recuerda que, en ambos casos, debes ajustar las rutas y ubicaciones de los archivos según la estructura de tu proyecto y el entorno específico de tu contenedor Docker.

Depuración en VSCode:

• Inicia el contenedor Docker con PHP y tu aplicación.
• Asegúrate de que el contenedor Docker esté configurado para exponer el puerto 9000, que es el puerto utilizado para la depuración.
• Haz clic en el botón de inicio de depuración en la barra lateral izquierda de VSCode o usa el atajo de teclado (generalmente F5) para iniciar la depuración.
• Ejecuta tu script PHP dentro del contenedor o realiza una solicitud HTTP a tu aplicación.
• VSCode debería detenerse en los puntos de interrupción y permitirte depurar tu código PHP.

Averiguar la ubicación del fichero php.ini en un Docker

Para averiguar la ruta del archivo php.ini en tu contenedor Docker, puedes seguir estos pasos:

1. Accede al contenedor Docker en el que está instalado PHP y Xdebug. Puedes hacerlo ejecutando el siguiente comando:

   docker exec -it <container_name_or_id> bash

Reemplaza <container_name_or_id> con el nombre o ID del contenedor Docker que deseas acceder.

2. Una vez dentro del contenedor, puedes usar el comando php --ini para ver la ubicación del archivo php.ini. Ejecuta el siguiente comando:

   php --ini

El comando mostrará una lista de archivos php.ini utilizados por PHP en diferentes configuraciones. Busca el archivo que corresponda a la configuración utilizada en tu entorno específico.

3. Anota la ruta completa del archivo php.ini que se muestra en la salida del comando php --ini.
4. Utiliza esa ruta completa para configurar el volumen en tu archivo docker-compose.yml o en el Dockerfile, como se mencionó anteriormente:

   volumes:
     - /ruta/completa/php.ini:/ruta/completa/php.ini

Reemplaza /ruta/completa/php.ini con la ruta que hayas obtenido del paso anterior.

Siguiendo estos pasos, deberías poder averiguar la ruta del archivo php.ini en tu contenedor Docker y configurar correctamente el volumen en tu archivo de configuración correspondiente.

Volumenes, hay dos url separadas por :, debo de poner la misma ubicación en ambos lados del :

Sí, en el caso de los volúmenes en Docker Compose, la notación “ruta_host:ruta_contenedor” indica la correspondencia entre una ruta en el host (tu máquina local) y una ruta en el contenedor.

Si has determinado que la ruta del archivo php.ini en tu contenedor Docker es /etc/php/8.2/cli/php.ini, entonces deberás proporcionar la misma ubicación en ambos lados del “:” en la sección de volúmenes.

Por ejemplo, si la ubicación de tu archivo php.ini en tu máquina local es /ruta/local/php.ini, puedes configurar el volumen de la siguiente manera:

volumes:
  - /ruta/local/php.ini:/etc/php/8.2/cli/php.ini

Esto indica que el archivo php.ini en tu máquina local se mapeará al archivo php.ini en la ubicación /etc/php/8.2/cli/php.ini dentro del contenedor Docker.

Asegúrate de reemplazar “/ruta/local/php.ini” con la ruta correcta de tu máquina local.

Con esta configuración, cualquier cambio realizado en el archivo php.ini en tu máquina local se reflejará en el contenedor Docker durante la ejecución.

Recuerda que los cambios en la configuración del contenedor pueden requerir que reinicies el contenedor para que los cambios surtan efecto.

Posible razón de error al intentar depurar:

Que no esté copiado el código fuente: https://stackoverflow.com/questions/66818064/laravel-docker-image-could-not-open-input-file-var-www-html-artisan

A veces puede haber configuraciones anteriores en la memoria, puede ser interesante probar a limpiar antes de intentarlo de nuevo.