Debug in the Just-In-Time mode
IntelliJ IDEA supports the use of Xdebug in the Just-In-Time (JIT) mode so it is not attached to your code all the time but connects to IntelliJ IDEA only when an error occurs or an exception is thrown. Depending on the Xdebug version used, this operation mode is toggled through the following settings:
Xdebug 2 uses the xdebug .remote_mode setting, which has to be set to
Xdebug 3 uses the xdebug.start_upon_error setting, which has to be set to
The mode is available both for debugging command-line scripts and for web server debugging.
Install the PHP plugin
This functionality relies on the PHP plugin that should be installed and enabled in your IDE.
The plugin is available only in IntelliJ IDEA Ultimate.
Press Ctrl+Alt+S to open the IDE settings and select.
Switch to the Marketplace tab and use the search field to find the PHP plugin.
Click Install and restart the IDE if prompted.
Configure Xdebug for using in the Just-In-Time mode
Depending on whether you are going to debug command-line scripts or use a Web server, use one of the scenarios below.
For debugging command-line scripts, specify the custom
-dxdebug.remote_mode=jit (for Xdebug 2) or
-dxdebug.start_upon_error=yes (for Xdebug 3) directive as an additional configuration option:
In the Settings/Preferences dialog (Ctrl+Alt+S), go to .
From the PHP executable list, choose the relevant PHP interpreter and click next to it.
In the CLI Interpreters dialog that opens, click next to the Configuration options field in the Additional area.
In the Configuration options dialog that opens, click to add a new entry.
xdebug.start_upon_errorin the Configuration directive field and
yesin the Value field.
xdebug.remote_modein the Configuration directive field and
jitin the Value field.
When you click OK, you return to the CLI Interpreters dialog where the Configuration options field shows
-dxdebug.remote_mode=jit(for Xdebug 2) or
-dxdebug .start_upon_error=yes(for Xdebug 3).
Web server debugging
From the main menu, choose.
In the Validate Remote Environment that opens, choose the Web server to validate the debugger on.
Choose Local Web Server or Shared Folder to check a debugger associated with a local Web server.
Path to Create Validation Script: In this field, specify the absolute path to the folder under the server document root where the validation script will be created. For Web servers of the type Inplace, the folder is under the project root.
The folder must be accessible through http.
URL to Validation Script: In this field, type the URL address of the folder where the validation script will be created. If the project root is mapped to a folder accessible through http, you can specify the project root or any other folder under it.
Choose Remote Web Server to check a debugger associated with a remote server.
Path to Create Validation Script: In this field, specify the absolute path to the folder under the server document root where the validation script will be created. The folder must be accessible through http.
Deployment Server: In this field, specify the server access configuration of the type Local Server or Remote Server to access the target environment. For details, see Configure synchronization with a Web server.
Choose a configuration from the list or click Browse in the Deployment dialog.
Click Validate to have IntelliJ IDEA create a validation script, deploy it to the target remote environment, and run it there.
Open the php.ini file which is reported as loaded and associated with Xdebug.
In the php.ini file, find the
Change the value of the
xdebug.start_upon_errorfrom the default
Change the value of the
xdebug.remote_modefrom the default
Xdebug connects to IntelliJ IDEA in the following two cases:
When an error occurs. In this case, Xdebug stops on the line right after the error condition. The reason for that is that IntelliJ IDEA first has to run the erroneous code before it knows something is wrong.
When an exception is thrown. If the exception is handled, Xdebug breaks at the first line of the
catchblock if there is one, or at the