phpday 2025 - Call For Papers

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

add a note

User Contributed Notes 1 note

up
1
Jeff B. Carter
1 year 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