PHP调试总卡壳？3个高手私藏断点技巧
|
去年11月，改版上线翻车——不是功能崩了，是 dev 环境里断点跳得比产品经理改需求还勤。我盯着 Xdebug 那个灰掉的断点图标看了四分钟，手悬在键盘上，F5 按下去前又缩回来，抬手、按键、松手，再抬手、按键、松手。隔壁测试小张端着保温杯路过，说“你这屏保怎么还是那只猫”，我才想起来双屏左边壁纸早该换了，右边那张是三年前在黄山拍的云海，灰了三回都没动过。 第一个技巧？别信 IDE 里的断点图标。我原以为 PhpStorm 的小红点真代表「命中有」，结果它只是前端渲染层画了个圆——后端压根没收到指令。有次卡在 Laravel 的 middleware 链里，断点标得整整齐齐，xdebug.log 里却连 request header 都没进。我敢打包票：那个红点，在 PHP-FPM 子进程 spawn 之前，纯属 UI 安慰剂。你信它，它就笑；你不信，它反而在你切到 Chrome DevTools 的 Console tab 时悄悄亮一下，再灭——专挑你刚喝完一口外卖汤、汤汁正从一次性盒盖边缘渗出来那会儿。 第二个，也是最野的：用 die() 做条件断点。不是 var_dump 后 exit，是真 die。但必须带 trace。写成 die(debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 1)); 这样——只打一层，够你反推调用链，又不刷屏。上周后端老陈提了个 PR，把 Illuminate\\Http\\Request::capture() 给包了一层 factory，我在他写的那段里插了三次 die()，第三次才看到他忘了 unset($_SERVER['argv'])，导致 Request 实例反复 clone。这事我说不准是不是他故意留的坑，但那三次 die 输出里，第二次和第三次中间差了三百七十二个节点，全是 illuminate/container 里 resolve 的匿名函数递归——根本没走注册的 binding，全靠反射硬撞。旁边工位阿哲键盘右下角 Shift 键早卡住了，每次输大写都得按两下，我就看着他打“$request->user()”打了六遍，第六遍才对。 第三个？不设断点。真不设。你去 php.ini 里把 xdebug.mode 改成 debug,develop，然后在 URL 末尾加 ?XDEBUG_SESSION_START=1873。浏览器一发请求，xdebug 就自动 attach。优胜劣汰就在这儿——能扛住自动 attach 的代码，才是真正活下来的。上个月测试提交了个 bug：“登录后首页白屏”，我一看日志发现是 V8 引擎报的 SyntaxError，顺藤摸瓜找到是某处 PHP 模板 echo 出了个未转义的 ``，而 JS 加载器恰好在 eval 字符串……这不是 PHP 调试的事，这是你当年答应 PM“页面秒开”时埋下的债。可债还得起，断点不一定找得到。我删过十七次 .idea/workspace.xml 里的 breakpoins.xml，它比 Git 本地分支还固执——删完重启 IDE，它又从某个 backup 文件夹里钻出来，带着 timestamp 为去年十一月十七号下午两点零三分的元数据。 说回去年11月那个翻车：线上 error_log 显示 “Call to undefined method Illuminate\\Database\\Query\\Builder::toRawSql()”，可我们压根没调这个方法。最后发现是同事改了 config/database.php，把 'sqlite' 的 prefix 写成 null，触发了 Query Builder 构造函数里一个隐藏 throw。那天凌晨三点，PM 微信弹出“用户说首页加载慢”，我正对着 chrome://inspect 里的 blank page 翻白眼，手里拎着半凉的酸辣粉，汤洒了一滴在机械键盘 F9 键上，刚好盖住那个本该触发 Xdebug 启动的按钮。我擦也没擦，就让它黏着。F9 后来没再响过。
文章配图，仅供参考 现在我倒水前必先关 xdebug.remote_autostart ——上回测试拿我电脑复现 bug，我起身去茶水间，她顺手点了刷新，Xdebug 就自己连上了她的 Mac 上装的 VS Code，IP 地址填的是她自己的 localhost:9003。她还不知道，她那台机器上 xdebug.client_host 居然配的是我的内网 IP。这种事没法写进 Wiki，写进去就等于承认我们连网络拓扑都靠直觉在维护。阿哲昨天问我 CSS class 名该不该加前缀，我说“你先看看你上个 PR 里改的 vendor 包里的 test 文件，那个 test 命名叫 testCanHandleNullWithoutBlowingUpButActuallyItDoesAnyway”。他笑了，笑得像极了上次我调试时看到的 xdebug.log 里那行 “[Step Debug] Could not connect to debugging client”。哦对，我工位上那个旧机械键盘的 ESC 键帽早掉了，露出底下银色触点，每次误触都发出清脆的“咔”声，跟 F5 声音不一样。F5 是闷的。ESC 是脆的。但调试时，你根本分不清哪声是你按的，哪声是 Xdebug 断线重连失败时自动触发的 socket reset 回声。反正都是咔。反正都不是你要的那个结果。下周一我去把 /etc/php/8.2/cli/conf.d/20-xdebug.ini 里那行 xdebug.start_with_request = trigger 改成 default，至少不用再猜——到底是谁按了那个键。 （编辑：站长网） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |
