Locally Debugging a PHP Script

This procedure describes how to debug a PHP Script from your workspace using an internal PHP Executable.


You must configure your PHP Executable through the PHP Executables Preferences page before you can debug locally.



Instructions on how to complete a procedure

To locally debug a PHP Script:

  1. Set breakpoints at the relevant places in the file that you would like to debug by double-clicking the vertical marker bar to the left of the editor.

  2. Save the file.

  3. Click the arrow next to the debug button debug_icon.png on the toolbar and select Debug Configurations... -or- select Run | Debug Configurations....
    A Debug dialog will open.

  4. Double-click the PHP Script option to create a new debug configuration.

New Debug Configuration

  1. Enter a name for the new configuration.

  2. S elect the required PHP executable.
    If no PHP Executables are listed, click the PHP Executable link and add a PHP Executable in the PHP Executable Preferences page. The PHP Executables must match the Debugger type.

  3. Select the PHP Debugger to be used. PDT supports both the Zend Debugger and XDebug.

  4. Enter your PHP file in the "PHP File" text field, or click Browse and select your file

  5. Marking the "Breakpoint" checkbox will result in the debugging process pausing at the first line of code.

  6. If necessary, you can add arguments in the PHP Script Arguments tab to simulate command line inputs.

  7. Click Apply and then Debug.

  8. Click Yes if asked whether to open the PHP Debug Perspective.

A number of views will open with relevant debug information.

See the Running and Analyzing Debugger results topic for more information on the outcome of a debugging process.


If the file contains 'include' or 'require' calls to files which are not contained within the project, you must add them to the project's Include Path in order to simulate your production environment.




Related Links:

Working with the Debugger


Debug Preferences

Debugging a PHP Web Page

Running and Analyzing Debugger Results

Run Menu

PHP Support