Previous | Next | See Also

File | Settings | Languages and Frameworks | PHP | Debug

The page is available only when the PHP  plugin is enabled.

The plugin is not bundled with IntelliJ IDEA, but it can be installed from the JetBrains plugin repository as described in Installing, Updating and Uninstalling Repository Plugins and Enabling and Disabling Plugins.

Use this page to configure the behaviour of the Xdebug and Zend Debugger debugging tools.

ItemDescription
Values tooltip delay In this tet box, specify the time period to pass between you hover the mouse pointer over a variable or another code element and a tooltip with the value of this element appears. This setting helps you avoid the situation when tooltips appear immediately as you move the mouse pointer through the code.
Safe evaluation mode
  • When this check box is selected, IntelliJ IDEA checks that the expression or code fragment to be evaluated does not contain any undefined elements and informs you about any discrepancies detected.
  • If the check box is cleared, an exception appears if IntelliJ IDEA encounters any undefined elements during evaluation.
Local debug In this area, customize local debugging, when the processed files are on your machine.
  • Pass required configuration options through command line (still need to enable debug extension manually): select this check box to have debugger configuration options passed through a command line.
External Connections In this area, specify how you want IntelliJ IDEA to treat connections received from hosts and through ports that are not registered as server configurations.
  • Ignore external connections through unregistered server configurations - select this check box to have IntelliJ IDEA ignore connections received from hosts and through ports that are not registered as server configurations. When this check box is selected, IntelliJ IDEA does not attempt to create a server configuration automatically.
Xdebug Use the controls in this area to configure debugging using the Xdebug tool.
  • Debug port: in this text box, specify the port for IntelliJ IDEA and the Xdebug engine to communicate through. This must be exactly the same port number as specified in the php.ini file: 
    xdebug.remote_port = <port_number>

    By default, Xdebug listens on port 9000.

  • Can accept external connections: select this check box to enable IntelliJ IDEA to accept any incoming connections from Xdebug engines through the port specified in the Debug port text box.
  • Force break at the first line when no path mapping is specified:
  • Force break at the first line when the script is outside the project:
Zend DebuggerUse the controls in this area to configure debugging using the Zend Debugger tool.
  • Debug port - in this text box, specify the port for IntelliJ IDEA and the Zend Debugger engine to communicate through. Type the port number within the tunnel specified in the php.ini file through zend_debugger.tunnel_min_port and zend_debugger.tunnel_max_port. For details, see http://files.zend.com/help/previous-version/Zend-Server-4-Community-Edition/zenddebugger.html
  • Can accept external connections - select this check box to enable IntelliJ IDEA to accept any incoming connections from Zend Debugger engines through the port specified in the Debug port text box.
  • Settings broadcasting port - in this text box, specify the port through which the debugger settings are passed to the debugging toolbar in the browser.
  • Ignore Z-Ray system requests - select this check box to block requests from the Z-Ray system if they annoy you by invoking the IntelliJ IDEA debugger too often.

If starting the Zend Debugger tool fails with the message "Port is busy", specify a port number of your choice higher than 10000.

Use debugger bookmarklets to initiate debugger from your favorite browser Follow this link to open the Zend Debugger & Xdebug bookmarklets page where you can generate bookmarklets through which you will start/stop a debugging session by controlling the debugger cookie.
Advanced Settings Notify if debug session was finished without being stopped - select this check box to have IntelliJ IDEA display a notification when no breakpoints are hit during Zero-Configuration debugging. This may happen if the path mappings are not configured or configured erroneously, or if you have not set any breakpoints. In the latter case, enabling the Run | Break at First Line in PHP Scripts option on the main menu may also help.

If the check box is cleared, no debugging sessions is established and the PHP script is just executed without being suspended.