Skip to content

dantleech/debug-tui

Repository files navigation

Debug-TUI

Interactive Xdebug step-debugging client for your terminal.

Demo

  • Travel forwards: step over, into and out.
  • Travel backwards: it's not quite time travel - but you can revisit previous steps in history mode.
  • Jump the stack: jump up and down the stack.
  • Vim-like motions: Typing 100n will repeat "step into" 100 times.
  • Inline values: Show variable values inline with the source code.

Installation

CLI options

  • --log: Debug log to file.
  • --listen: Listen on an alternative address (defaults to 0.0.0.0:9003).

Key bindings

Prefix with number to repeat:

  • r run
  • n next / step into
  • N step over
  • p previous (switches to history mode if in current mode)
  • o step out
  • j down
  • J down 10
  • k up
  • K up 10
  • h left
  • H left 10
  • l right
  • L right 10
  • + increase context depth
  • - decrease context depth
  • tab switch pane
  • enter toggle pane focus (full screen)
  • t rotate the theme
  • ? Show help
  • f Filter (context pane) - use dot notation to filter on multiple levels.

Setting Breakpoints

debug-tui has no mechanism for setting a breakpoint but you can use the function xdebug_break() in your code:

<?php

function my_function() {
    xdebug_break(); // break after this line
}

About

Interactive PHP step debugger for your terminal. Made on planet earth with effort.

Resources

Stars

Watchers

Forks

Packages

No packages published