Validating the Configuration of a Debugging Engine
IntelliJ IDEA can validate your configuration of Xdebug or Zend Debugger and tell you if some setting is missing
xdebug.remote_enable) or inconsistent with other settings.
When configuring the PHP interpreter for a project, IntelliJ IDEA informs you whether a debugger is installed in your local PHP development environment
and reports on the Xdebug or Zend Debugger version used.
For details, see Configuring a Debugging Engine and Enabling PHP Support.
You can also validate the debugger setup in a remote environment.
On this page:
- Checking the Debugger Installation in a Local Environment
- Checking the Debugger Configuration in a Remote Environment
Checking the Debugger Installation in a Local Environment
- Open the Settings dialog box by choosing , then click PHP under Languages & Frameworks. The PHP page opens.
- On the PHP page, choose the relevant PHP installation from the Interpreter drop-down list and click the Browse button next to the field. The list shows all the PHP installations available in IntelliJ IDEA, see Enabling PHP Support.
The Interpreters dialog box that opens shows the following:
- The version of the selected PHP installation.
The name and version of the debugging engine associated with the selected PHP installation (Xdebug or Zend Debugger).
If no debugger is configured, IntelliJ IDEA shows
Debugger: Not installed.
Checking the Debugger Configuration in a Remote Environment
In the context of IntelliJ IDEA, the term remote denotes any environment outside the project root. This can be a server on physically remote host, or a Vagrant box, or a server on the same machine but in a folder outside your project root.
- To configure synchronization with the target remote environment, create a server access configuration of the type Local Server or Remote Server, for details see Configuring Synchronization with a Web Server.
- On the PHP page of the Settings dialog box, choose the relevant PHP installation from the Interpreter drop-down list and click Apply. For details, Enabling PHP Support.
- On the Servers page of the Settings dialog box, specify the host nad port of the target environment and choose the debugging engine to use. Click OK.
- On the main menu, choose .
In the Validate Remote Environment Dialog that opens, specify the server access configuration to synchronize with the environment and click Validate.
IntelliJ IDEA runs a validation script and displays the results in the Information area:
The currently active
- The available debugging engine.
- Detected discrepancies in configuration.
- The currently active