PhpStorm 8.0.0 Web Help

File | Settings | PHP | Debug

Note

The page and all the pages under this node are available only when the PHP plugin is enabled. The plugin is bundled with PhpStorm and activated by default. If not, enable it as described in Enabling and Disabling Plugins.

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

Item Description
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, PhpStorm 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 PhpStorm 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 PhpStorm 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 PhpStorm ignore connections received from hosts and through ports that are not registered as server configurations. When this check box is selected, PhpStorm 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 PhpStorm 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 PhpStorm 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 Debugger Use the controls in this area to configure debugging using the Zend Debugger tool.
  • Debug port - in this text box, specify the port for PhpStorm 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 PhpStorm 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.

Tip

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.

See Also

Procedures:

Reference:

External Links:

Web Resources: