Cómo habilitar el módulo Xdebug integrado de ServBay

Como una poderosa herramienta de desarrollo web integrada, ServBay viene con un módulo Xdebug, y su activación es muy sencilla. Xdebug es una herramienta de depuración y análisis para PHP que ayuda a los desarrolladores con la depuración de código, el análisis de rendimiento y la detección de cobertura de código. Es un recurso invaluable para el desarrollo y mantenimiento de aplicaciones PHP.

Introducción al módulo Xdebug

Xdebug es una extensión avanzada de PHP para depuración y análisis de código PHP. Ofrece funciones de depuración ricas, incluyendo depuración por puntos de interrupción, trazas de pila y monitoreo de variables. Además, Xdebug soporta análisis de rendimiento y detección de cobertura de código, ayudando a los desarrolladores a optimizar el rendimiento del código y asegurar la calidad del mismo.

Principales características

1. Depuración por puntos de interrupción: Xdebug permite establecer puntos de interrupción en el código, depurar línea por línea, facilitando la identificación y corrección de errores.
2. Trazas de pila: En caso de error, Xdebug puede generar información detallada de la traza de pila, ayudando a los desarrolladores a localizar problemas rápidamente.
3. Análisis de rendimiento: Xdebug ofrece funciones de análisis de rendimiento, generando informes detallados para ayudar a optimizar el rendimiento del código.
4. Cobertura de código: Xdebug soporta la detección de cobertura de código, asegurando que las pruebas cubren todas las rutas de código.
5. Soporte para entornos de desarrollo integrados: Xdebug se puede integrar con varios entornos de desarrollo integrados (IDE) como PHPStorm, Visual Studio Code, etc., ofreciendo una experiencia de depuración conveniente.

Versión del módulo Xdebug incluido en ServBay

ServBay soporta múltiples versiones de PHP y para cada versión tiene preinstalado el módulo Xdebug correspondiente. Las versiones específicas son:

• PHP 5.6, 7.0, 7.1: Xdebug 2.5.5
• PHP 7.2, 7.3, 7.4: Xdebug 3.1.6
• PHP 8.0, 8.1, 8.2, 8.3: Xdebug 3.3.1
• PHP 8.4: Xdebug 3.4.0-dev

Consejo

Cada versión de PHP tiene su puerto de Xdebug independiente, relacionado con el número de versión, por ejemplo, el puerto Xdebug de PHP 7.2 es 39072, y el de PHP 8.3 es 39083.

Cómo habilitar el módulo Xdebug

Por defecto, el módulo Xdebug está deshabilitado. Habilitarlo es muy sencillo, solo necesitas navegar a lenguaje-PHP, seleccionar la versión de PHP que deseas activar, por ejemplo, PHP 8.4, hacer clic en extensiones a la derecha, luego activar el interruptor a la izquierda del módulo Xdebug y guardar.

Los usuarios también pueden abrir o modificar la configuración del módulo manualmente, siguiendo estos pasos detallados:

Paso 1: Encuentra el archivo de configuración

Primero, localiza el directorio conf.d de la versión de PHP correspondiente. Por ejemplo, para habilitar el módulo Xdebug para PHP 8.3, necesitamos editar el siguiente archivo:

/Applications/ServBay/etc/php/8.3/conf.d/xdebug.ini

Paso 2: Edita el archivo de configuración

Abre el archivo xdebug.ini y descomenta lo siguiente:

[Xdebug]
; Uncomment the following line to enable XDebug
zend_extension = xdebug.so

Paso 3: Configura los parámetros de Xdebug

Para utilizar completamente las funciones de Xdebug, puedes configurar algunos parámetros comunes en el xdebug.ini. Por ejemplo:

xdebug.mode=debug,develop
xdebug.start_with_request=yes
xdebug.client_host=localhost
xdebug.client_port=39083
xdebug.log=/Applications/ServBay/logs/xdebug/8.3/xdebug.log

Paso 4: Reinicia el servicio PHP

En el panel de gestión de servicios de ServBay, reinicia el servicio PHP correspondiente. Por ejemplo, reinicia el servicio PHP 8.3. Una vez completado, el módulo Xdebug se cargará exitosamente.

Verifica si el módulo Xdebug se cargó correctamente

Puedes crear un archivo PHP simple para verificar si el módulo Xdebug se cargó correctamente. Crea un archivo phpinfo.php en el directorio raíz del servidor web con el siguiente contenido:

<?php
phpinfo();
?>

Accede a https://servbay.host/phpinfo.php, y en la página de información de PHP, busca información relacionada con el módulo Xdebug. Si ves la información de Xdebug, el módulo ha sido cargado exitosamente.

Configuración de Xdebug en PHPStorm

Para usar Xdebug para depurar en PHPStorm, necesitas seguir los siguientes pasos de configuración:

Paso 1: Abre PHPStorm y entra a la configuración

1. Abre PHPStorm.
2. Haz clic en File en la barra de menú y luego selecciona Settings (Windows/Linux) o Preferences (macOS).

Paso 2: Configura el intérprete de PHP

1. En la ventana de configuración, navega a Languages & Frameworks -> PHP.
2. En la sección CLI Interpreter, haz clic en el botón ... a la derecha.
3. En la ventana emergente, haz clic en + para añadir un nuevo intérprete de PHP, elige Local.
4. Establece la ruta del intérprete de PHP al camino correspondiente en ServBay, por ejemplo, /Applications/ServBay/package/php/8.3/8.3.7/bin/php.
5. Haz clic en OK para guardar la configuración.

Paso 3: Configura la depuración de Xdebug

Consejo

Cada versión de PHP tiene su puerto de Xdebug independiente, relacionado con el número de versión, por ejemplo, el puerto Xdebug de PHP 7.2 es 39072, y el de PHP 8.3 es 39083.

1. En la ventana de configuración, navega a Languages & Frameworks -> PHP -> Debug.
2. En la sección Xdebug, establece Debug Port en 39083, coincidiendo con la configuración xdebug.client_port.
3. Asegúrate de que la opción Can accept external connections esté seleccionada.
4. Haz clic en Apply y luego OK para guardar la configuración.

Paso 4: Configura el servidor de aplicaciones web PHP

1. En la ventana de configuración, navega a Languages & Frameworks -> PHP -> Servers.
2. Haz clic en el + a la derecha para añadir una nueva configuración de servidor.
3. Establece el nombre del servidor, por ejemplo, ServBay Localhost.
4. Establece Host al host correspondiente en ServBay, como servbay.new, puerto 443 (HTTPS).
5. Establece Debugger en Xdebug.
6. Haz clic en OK para guardar la configuración.

Paso 5: Inicia la sesión de depuración

1. En PHPStorm, abre el proyecto PHP que deseas depurar.
2. Establece puntos de interrupción en el código (haciendo clic en el área en blanco a la izquierda del número de línea).
3. Haz clic en el botón Start Listening for PHP Debug Connections (icono de insecto pequeño) en la barra de herramientas superior de PHPStorm.
4. Accede a tu aplicación PHP en el navegador, y Xdebug se conectará automáticamente a PHPStorm, deteniéndose en los puntos de interrupción.

Conclusión

ServBay proporciona una manera conveniente de gestionar y habilitar el módulo Xdebug. Con una configuración y reinicio sencillos, los desarrolladores pueden habilitar rápidamente el módulo Xdebug en diferentes versiones de PHP, aprovechando sus potentes funciones de depuración y análisis para mejorar la eficiencia en el desarrollo y mantenimiento de aplicaciones PHP. Las funciones de Xdebug como depuración por puntos de interrupción, análisis de rendimiento y detección de cobertura de código lo convierten en una herramienta indispensable para los desarrolladores PHP.