PhpStorm 2017.3 Help

Stepping Through the Program

In this section:

Introduction

When a breakpoint is reached the Debug tool window becomes active and enables you to get control over the program's execution. For this purpose, you can use the Run menu commands, or the icons on the stepping toolbar of in the Debug tool window.

Each stepping action advances the execution point to the next execution location, depending on the action you choose.

Stepping through the program

Do one of the following:

  • On the main Run menu, or on the editor's context menu, choose one of the <stepping command>
    ps debug tool window stepping main menu
  • Use the keyboard shortcuts.
  • Use the buttons in the stepping toolbar of the Debug tool window.

Suppressing stepping into

You can create a list of scripts, methods, and functions that you want the debugger skip while stepping through the program.

  1. Open the Settings / Preferences Dialog by pressing Ctrl+Alt+S or by choosing File | Settings for Windows and Linux or PhpStorm | Preferences for macOS. Expand the Buld, Execution, Deployment node, and then click page_name under Debugger.
  2. On the Debugger. Stepping page that opens:
    • To have the debugger skip all library scripts, select the Do now step into library scripts checkbox.
    • To suppress stepping into some specific scripts, select the Do not step into scripts checkbox and create a list of such scripts using the toolbar buttons.
  3. To have some PHP methods skipped, specify them on the Step Filters page:
    1. Open the Settings / Preferences Dialog by pressing Ctrl+Alt+S or by choosing File | Settings for Windows and Linux or PhpStorm | Preferences for macOS. click Step Filters under Debug.
    2. On the Step Filters page that opens, select the checkboxes next to the relevant method types: Magic methods and Constructors.
    3. If necessary, add specific methods to the Skipped Methods list using the new toolbar button.

Tips and tricks

  • The Force Step Into command frames step into enables you to step into a method of a class not to be stepped into.
    The classes, stepping into which is suppressed, are specified on the Debugger. Stepping page of the Settings/Preferences dialog box.
  • The Force Step Over command force step over enables you to jump over the method call ignoring the breakpoints on the way.
  • The Force Run to Cursor command frames run to cursor enables you to jump to the cursor position ignoring existing breakpoints on the way.
Last modified: 6 December 2017

See Also

Concepts: