You are here: User Guide > Tasks > Profiling Files and Applications > Installing the Zend Debugger

Installing the Zend Debugger

The Zend Debugger is the PHP extension which should be installed on your Web server in order to perform optimal remote debugging and profiling using Zend Studio, and can be downloaded as a standalone package and installed onto your server.

 

 

Instructions on how to complete a procedure

To install the Zend Debugger on your server:

  1. Download the Studio Web Debugger package which corresponds to your operating system from http://www.zend.com/en/products/studio/downloads.

  2. Extract the Zend Debugger package to a temporary folder.

  3. 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).
  4. Copy the file to your Web server in a location that is accessible by the Web server.

  5. To load the Zend Debugger, add the following line (which corresponds to your operating system) to your php.ini file:

  • Linux and Mac 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>

    Note:

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

  1. To authorize your Zend Studio to access the Zend Debugger, add the following lines to your php.ini file:
    zend_debugger.allow_hosts=<host_ip_addresses>
    zend_debugger.expose_remotely=always
  2. Replace <host_ip_addresses> with the IPs of the hosts which will be allowed to initiate debug sessions (this should be the IPs of the machines on which Zend Studio is installed.

    Note:

    <host_ip_addresses> should be entered in the format X.X.X.X (e.g. 10.1.2.21). Multiple IP addresses should be separated by commas. You can also use a net mask to denote ‘wild card’ IP addresses (e.g. 10.1.2.0/24 would include all IP addresses with the prefix 10.1.2).

  3. The zend_debugger.expose_remotely directive determines whether the debugger will expose itself (i.e. signal its presence) to remote clients. This is required if you want the Zend Studio Browser Toolbar to automatically detect pages that can be debugged. Select ‘always’, ‘never’, or ‘allowed_hosts’ (this only exposes the hosts in the allowed host list)

  4. Copy the dummy.php file from the extracted Zend Debugger directory to your document root directory.

  5. Restart your Web server.

For more information on setting up remote debugging on Zend Studio, see Setting Up Remote Debugging.

 

 

Related Links:

Debugging

Profiling

Setting Up Remote Debugging

Remotely Debugging a PHP Script

Remotely Profiling a PHP Script

 

 

 

©1999-2012 Zend Technologies LTD. All rights reserved.