Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Xdebug

To use Xdebug running in a haze instance with your IDE for debugging, you need to tell you IDE how to properly map the path from the container to the host. The IDE debugger configuration usually looks like:

	{
		"label": "PHP: Debug server within docker",
		"adapter": "Xdebug",
		"request": "launch",
		"port": 9003,
		"pathMappings": {
			"/var/www/html": "<sources_root_configured_in_haze.toml>",
			"/var/www/html/apps-extra": "<app_directories_configured_in_haze.toml>",
		},
	},

This would have to be adapted for detached instances.

Debugging all requests

By default, Xdebug is configured to only run for requests that containing the trigger (e.g. from using the Xdebug browser extension, or adding ?XDEBUG_SESSION_START=1 to the URL).

To enable Xdebug for all requests:

  • Un-comment the lines in haze [cloud-id] edit /config/php.ini
  • Then run haze reload [cloud-id]