PhpStorm 8.0.0 Web Help

Configuring the Zend Debugger tool involves:

Downloading and installing Zend Debugger
  1. Download the Zend Debugger package which corresponds to your operating system.
  2. Locate the ZendDebugger.so (Unix) or ZendDebugger.dll (Windows) file in the directory which corresponds to your version of PHP (e.g. 4.3.x, 4.4.x, 5.0.x, 5.1.x, 5.2.x, 5.3.x, 5.4.x).
  3. Copy the file to your Web server in a location that is accessible by the Web server.
Enabling Zend Debugger integration with the PHP engine
  1. Locate and open the active php.ini file.

    Tip

    To find out which php.ini file is active, create and run a test file with phpinfo(), then search for the Loaded Configuration File.

  2. Locate or create the [Zend] section.
  3. To load the Zend Debugger extension, add one of the following lines inside the [Zend] section depending on your operating system:
    • Linux and OS X:
      zend_extension=<full_path_to_ZendDebugger.so>
                          
    • Windows:
      zend_extension_ts=<full_path_to_ZendDebugger.dll>
                          
    • Windows non-thread safe:
      zend_extension=<full_path_to_ZendDebugger.dll>
                          

      Warning

      The Windows non-thread safe binary file is only used with Zend Core 2.0.

  4. To enable access to Zend Debugger from PhpStorm, add the following lines:
    zend_extension=<full_path_to_zend_debugger_extension>
    zend_debugger.allow_hosts=127.0.0.1
    zend_debugger.expose_remotely=allowed_host
    zend_debugger.tunnel_min_port=<any integer value above 1024>
    zend_debugger.tunnel_max_port=<any integer value below 65535>
                

    The value of the zend_debugger.allow_hosts parameter is the IPs of your machine to connect to the server debugger. It could be a comma-separated list of IPs in the format X.X.X.X (for example, 192.168.0.6).

    Tip

    For a thread-safe Windows binary use the zend_extension_ts parameter instead of zend_extension.

  5. Restart your Web server.
  6. To check that the Zend Debugger has been installed and configured correctly, create a file with the following contents:
    <?php
        phpinfo();
    ?>
                
    Open the page that corresponds to the file in the browser. The output should contain a Zend Debugger section.
Integrating Zend Debugger with PhpStorm
  1. Open the Project Settings and click PHP.
  2. On the PHP page that opens, click the Browse button browseButton next to the Interpreter drop-down list.
  3. In the Interpreter dialog box that opens, choose Zend Debugger from the Debugger drop-down list.
  4. Define the Zend Debugger behaviour. Click Debug under the PHP node. On the Debug page that opens, specify the following settings in the Zend Debugger area:
    • In the Debug Port text box, appoint the port for PhpStorm to communicate with the tool 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
    • To have PhpStorm accept any incoming connections from Zend Debugger engines through the port specified in the Debug port text box, select the Can accept external connections check box.
    • To use a debugger toolbar in the browser, specify the port through which the debugger settings are passed to the browser in the Settings broadcasting port text box.
  5. To have Zend Debugger stop as soon as connection between it and PhpStorm is established (instead of running automatically until the first breakpoint is reached), turn on the Run | Break at first line in PHP scripts option on the main menu.

See Also

Procedures:

Reference:

External Links:

Web Resources: