# Locally Debugging a PHP Script

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

#### Note:

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

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 on the toolbar and select Debug Configurations... -or- select Run | Debug Configurations.... A Debug dialog will open.
4. Double-click the PHP CLI Application option to create a new debug configuration.

5. Enter a name for the new configuration.
6. Select the appropriate PHP Executable in Runtime PHP section. If no PHP Executables are available, click the Installed PHPs button and add a PHP Executable in the PHP Executable Preferences page.
7. Enter your PHP file in the "PHP File" text field, or click Browse and select your file
8. Marking the "Break at First Line" checkbox will result in the debugging process pausing at the first line of code.
9. If necessary, you can add arguments in the Script Arguments section to simulate command line inputs.
10. Click Apply and then Debug.
11. 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.

#### Note:

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
- Debugging
- Debug Preferences
- Debugging a PHP Web Page
- Running and Analyzing Debugger Results
- Run Menu
- PHP Support