phpdbg(1)

💅 phpdbg — the manual, but make it cute

okay so bestie, you've stumbled into phpdbg(1) from the Scripting Language section of the manual. buckle up, we're debugging PHP and we're gonna look iconic doing it 🎀

---

✨ NAME ✨

phpdbg — the interactive PHP debugger. that's it, that's the name, and she serves 💖

---

🌸 SYNOPSIS 🌸

phpdbg [options] [file] [args...]

---

🦋 DESCRIPTION 🦋

phpdbg is a lightweight, powerful, easy to use debugging platform for PHP. no cap. she's small, she's mighty, and she's literally here to help you figure out why your code is acting up. main character energy fr fr 🔥

---

👑 OPTIONS 👑

so many flags, all of them valid, all of them yours to slay with:

• -c path|file — look for the php.ini file in the directory path, or just use the specified file directly. choose your own adventure ✨
• -d foo[=bar] — define INI entry foo with value bar. set it, forget it, live your truth 💅
• -n — no php.ini file will be used. at all. none. zero. bye 👋
• -z file — load Zend extension file. bringing extra friends to the party 🫶
• -q — do not print the banner on startup. quiet mode, mysterious mode, lowkey mode 🤫
• -v — enable oplog output. let's see those opcodes, periodt
• -b — disables use of color on the console. sad for the vibes but great for your logs 😭
• -i path|file — override the .phpgdbinit location (this implies -I btw, sneaky)
• -I — ignore .phpdbginit (the default init file). ghosted 🚫
• -r — jump straight to run. no small talk, no warmup, straight to business
• -e — generate extended information for debugger/profiler. the tea is detailed ☕
• -E — enable step through eval(). yes bestie, even the eval'd code gets stepped through, we don't play favorites
• -s delimiter — read code to execute from stdin with an optional delimiter. piping code in like a hacker in a movie 🧚
• -S sapi_name — override the SAPI name. identity crisis, but make it intentional 🌈
• -p opcode — output opcodes and quit. show me the opcodes and then leave 💀
• -h — print the help overview. when in doubt, ask her
• -V — version number. who are you, really?
• args... — arguments passed to the script. use -- args when the first argument starts with - or the script is read from stdin ⭐

---

📝 NOTES 📝

passing -rr will cause phpdbg to quit after execution, rather than returning to the console. double r = double the exit, she's not coming back bestie 💀

---

🎀 FILES 🎀

• php.ini — the standard configuration file
• .phpdbginit — the init file

---

💜 SEE ALSO 💜

the online manual can be found at http://php.net/manual/book.phpdbg.php — go read it, iykyk 🦋

---

🙈 BUGS 🙈

you can view the list of known bugs or report any new bug you found at https://github.com/php/php-src/issues. not me sending a bug report at 3am... 😭

---

🌟 AUTHORS 🌟

written by Felipe Pena, Joe Watkins and Bob Weinand, formatted by Ondřej Surý for the Debian project. absolute legends, all of them 👑

a list of active developers can be found at http://www.php.net/credits.php

and last but not least, PHP was developed with the help of a huge amount of contributors all around the world. the global group chat really came through 🫶🌍

---

💫 VERSION INFORMATION 💫

this manpage describes phpdbg, for PHP version 8.3.6. yes, that specific one ✨

---

⚖️ COPYRIGHT ⚖️

Copyright © The PHP Group

this source file is subject to version 3.01 of the PHP license, that is bundled with this package in the file LICENSE, and is available through the world-wide-web at the following url: https://www.php.net/license/3_01.txt

if you did not receive a copy of the PHP license and are unable to obtain it through the world-wide-web, please send a note to license@php.net so we can mail you a copy immediately. legal besties, we got you 💌

---

and that's the whole page bestie — brought to you by The PHP Group, dated 2024, signed off from the phpdbg(1) manual itself. stay debugging, stay iconic, mwah 💅💖