PHP 8.4.6 Released!

phpdbg_break_file

(PHP 5 >= 5.6.3, PHP 7, PHP 8)

phpdbg_break_fileInserts a breakpoint at a line in a file

Description

phpdbg_break_file(string $file, int $line): void

Insert a breakpoint at the given line in the given file.

Parameters

file

The name of the file.

line

The line number.

Return Values

No value is returned.

See Also

User Contributed Notes

Jeff B. Carter
2 years ago
Here is an example of how to programmatically add a breakpoint based on a condition:

<?php
$blah
= 'meh';
if (
$blah !== 'blah') {
phpdbg_break_file('blah.php', 6);
}
$blah = 'blah';
echo
$blah;
?>

OUTPUT when running the debugger (using ev to evaluate the value of $blah after each step):

C:\path\to\dir>phpdbg -e blah.php
[Welcome to phpdbg, the interactive PHP debugger, v8.1.6]
To get help using phpdbg type "help" and press enter
[Please report bugs to <http://bugs.php.net/report.php>]
[Successful compilation of C:\path\to\dir\blah.php]
prompt> run
[Breakpoint #0 added at C:\path\to\dir\blah.php:6]
[Breakpoint #0 at C:\path\to\dir\blah.php:6, hits: 1]
>00006: $blah = 'blah';
00007: echo $blah;
00008: ?>
prompt> ev $blah
meh
prompt> step
>00007: echo $blah;
00008: ?>
prompt> ev $blah
blah
prompt> step
blah>00008: ?>
prompt> step
[Script ended normally]
To Top