phpdbg(1)

💅 phpdbg(1) — the interactive PHP debugger, bestie edition

okay so real talk: the tool we're talking about here is phpdbg from the phpdbg(1) manual, and it's genuinely one of those glow-up utilities that people sleep on. it's the interactive PHP debugger, and yes, she's that girl.

---

✨ SYNOPSIS ✨

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

---

🦋 DESCRIPTION 🦋

phpdbg is a lightweight, powerful, easy to use debugging platform for PHP. that's it. that's the whole vibe. lowkey iconic that it's all three at once — lightweight and powerful, like she shows up in sweatpants and still eats. 🔥

---

🎀 OPTIONS 🎀

bestie, there are a lot of them, but like... don't panic. we're getting through all of them, together, no skips. 💖

• -c path|file — hunt for the php.ini file in the directory path, or just point her straight at the specified file. you choose, main character.
• -d foo[=bar] — define that INI entry foo with the value bar. setting the vibes, manually.
• -n — no php.ini file will be used. at all. zero. she's going commando. 🙈
• -z file — load a Zend extension from file. let her accessorize.
• -q — do NOT print the banner on startup. stealth mode. quiet luxury. 🤫
• -v — enable oplog output. she's logging her ops, ngl.
• -b — disables use of color on the console. (sad, i know, but sometimes you need it for piping/scripting and stuff) 😭
• -i path|file — override the .phpgdbinit location. important: this implies -I.
• -I — ignore .phpdbginit (that's the default init file, for the record). she simply does not see it. not today. 💅
• -r — jump straight to run. no warmup, no small talk, we're going. 🏃‍♀️
• -e — generate extended information for debugger/profiler. more data, more slay.
• -E — enable step through eval(). yes, even the sneaky eval code gets stepped through.
• -s delimiter — read code to execute from stdin, with an optional delimiter. stdin girlies rise. 🫶
• -S sapi_name — override the SAPI name. she can go by a different name if she wants, it's giving alter ego.
• -p opcode — output opcodes and quit. show me the opcodes and then exit, thank you. ✨
• -h — print the help overview. when in doubt, ask for help, it's not a weakness, it's strategy.
• -V — version number. a little "who am i" moment. 👑
• args... — arguments passed to the script. big important note: use -- before args when the first argument starts with - or when the script is read from stdin. don't get got by this one.

---

💀 NOTES 💀

passing -rr will cause phpdbg to quit after execution, rather than returning to the console. so like, -r twice = she runs and then dips. no lingering, no afterparty. remember this one fr fr, it's a whole different behavior. ⭐

---

🌸 FILES 🌸

• php.ini — the standard configuration file. the basics. the canon.
• .phpdbginit — the init file. her little pre-show ritual.

---

🌈 SEE ALSO 🌈

the online manual can be found at http://php.net/manual/book.phpdbg.php. go read it, iykyk, there's lore in there. 📚

---

🐛 BUGS 🐛

you can view the list of known bugs, or report any new bug you found, at https://github.com/php/php-src/issues. if you find one, be brave, be loud, be specific. 🫶

---

💜 AUTHORS 💜

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

a list of active developers can be found at http://www.php.net/credits.php — go give them their flowers, they earned them.

and last but not least, PHP was developed with the help of a huge amount of contributors all around the world. genuinely iconic, global, no cap. 🌍✨

---

🧚 VERSION INFORMATION 🧚

this manpage describes phpdbg, for PHP version 8.3.36. so like... that's the one you're reading about. ⭐

---

👑 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 stuff but make it supportive. 💌

---

okay that's the whole page bestie, go debug something gorgeous 💖

The PHP Group 🌸 2024 🌸 — that's the source, that's the date, that's the sign-off, mwah 💅