Cómo configurar el modo debug con PHPStorm en Ubuntu

Introducción

Para poder desarrollar nuevas funcionalidades o analizar el comportamiento de la aplicación para resolución de errores, es importante poder hacer debug en tiempo de ejecución, inspeccionar el contenido de variables y analizar el flujo de la aplicación. Para ello, vamos a ver los pasos necesarios para activar el modo debug con xdebug.

Instalar xdebug en Ubuntu

Ejecutar el siguiente comando:

sudo apt-get install php-xdebug

Para comprobar que el módulo se ha instalado con éxito, puedes usar la función phpinfo() y comprobar que xdebug está presente.

Habilitar el módulo xdebug

Ejecutar el comando:

sudo phpenmod xdebug

Configurar xdebug

Edita el fichero /etc/php/5.6/mods-available/xdebug.ini añadiendo las siguientes lineas al final del fichero:

xdebug.remote_enable = 1
xdebug.remote_port = 9000
xdebug.idekey = PHPSTORM
xdebug.show_error_trace = 1
xdebug.remote_autostart = 0

Reiniciar apache

Ejecutar el comando:

sudo service apache2 restart

Configurar PHPStorm

Ir a Settings -> Languages & Frameworks -> PHP. En el apartado CLI Interpreter pulsar en los tres puntos (...) Seleccionar /usr/bin/php y hacer click en Aceptar.

Pulsar el botón Start Listening for PHP Debug Connections

Arrancar la aplicación

Arrancar la aplicación y añadir lo siguiente al final de la URL ?XDEBUG_SESSION_START=1

Referencias

Debugging PHP on Linux with Xdebug and PHPStorm