PhpStorm 10.0 Help

Debug

File | Settings | Languages and Frameworks | PHP | Debug for Windows and Unix
PhpStorm | Preferences | Languages and Frameworks | PHP | Debug for OS X


The page is available only when the PHP plugin is enabled. The plugin is bundled with PhpStorm and activated by default. If the plugin is not activated, enable it on the Plugins page of the Settings / Preferences Dialog as described in 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, 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 DebuggerUse 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.
  • Ignore Z-Ray system requests - select this check box to block requests from the Z-Ray system if they annoy you by invoking the PhpStorm debugger too often.
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 PhpStorm 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.

See Also

Last modified: 23 December 2015