devilbox/docs/intermediate/configure-php-xdebug/macos/phpstorm.rst

orphan

Docker on MacOS: Xdebug for PhpStorm

Note

Docker on MacOS requires you to create a host address alias on your loopback device.

Table of Contents

local

Prerequisites

Ensure you know how to customize php.ini values for the Devilbox and have a rough understanding about common Xdebug options.

* php_ini * configure_php_xdebug_options

Important

Ensure you have created an howto_host_address_alias_on_mac and 10.254.254.254 is aliased to your localhost.

Assumption

For the sake of this example, we will assume the following settings and file system paths:

Directory	Path
Devilbox git directory	/home/cytopia/repo/devilbox
env_httpd_datadir	./data/www
Resulting local project path	/home/cytopia/repo/devilbox/data/www
Selected PHP version	5.6
Host address alias	10.254.254.254 (see prerequisites)

The Resulting local project path is the path where all projects are stored locally on your host operating system. No matter what this path is, the equivalent remote path (inside the Docker container) is always /shared/httpd.

Important

Remember this, when it comes to path mapping in your IDE/editor configuration.

Configuration

Configure PhpStorm

1. Ensure Xdebug port is set to 9000

2. Set path mapping

Create a new PHP server and set a path mapping. This tutorial assumes your local Devilbox projects to be in ./data/www of the Devilbox git directory:

Important

Recall the path settings from the Assumption section and adjust if your configuration differs!

3. Ensure DBGp proxy settings are configured

Configure php.ini

Note

The following example show how to configure PHP Xdebug for PHP 5.6:

Create an xdebug.ini file (must end by .ini):

# Navigate to the Devilbox git directory
host> cd path/to/devilbox

# Navigate to PHP 5.6 ini configuration directory
host> cd cfg/php-ini-5.6/

# Create and open debug.ini file
host> vi xdebug.ini

Copy/paste all of the following lines into the above created xdebug.ini file:

; Defaults
xdebug.default_enable=1
xdebug.remote_enable=1
xdebug.remote_port=9000

; The MacOS way
xdebug.remote_connect_back=0
xdebug.remote_host=10.254.254.254

; idekey value is specific to PhpStorm
xdebug.idekey=PHPSTORM

; Optional: Set to true to always auto-start xdebug
xdebug.remote_autostart=false

Important

Ensure you have created a howto_host_address_alias_on_mac pointing to 10.254.254.254 as stated in the prerequisites section above!

Note

Host os and editor specific settings are highlighted in yellow and are worth googling to get a better understanding of the tools you use and to be more efficient at troubleshooting.

Restart the Devilbox

Restarting the Devilbox is important in order for it to read the new PHP settings. Note that the following example only starts up PHP, HTTPD and Bind.

# Navigate to the Devilbox git directory
host> cd path/to/devilbox

# Stop, remove stopped container and start
host> docker-compose stop
host> docker-compose rm
host> docker-compose up php httpd bind

start_the_devilbox_stop_and_restart (Why do docker-compose rm?)