加入收藏 | 设为首页 | 会员中心 | 我要投稿 站长网 (https://www.52php.cn/)- 应用程序、AI行业应用、CDN、低代码、区块链!
当前位置: 首页 > 站长学院 > PHP教程 > 正文

PHP调试太难?H5开发者必备5大网站调试技巧

发布时间:2026-11-11 08:33:07 所属栏目:PHP教程 来源:DaWei
导读:文章配图,仅供参考  去年2月,凌晨三点十七分,我盯着后台日志里第七次重复的「undefined index: user_role」,手边那瓶农夫山泉喝到只剩四分之一,笔记本电量百分之十三——屏幕右下角那个小电池图标已经开始发烫。会议室

文章配图,仅供参考

  去年2月,凌晨三点十七分,我盯着后台日志里第七次重复的「undefined index: user_role」,手边那瓶农夫山泉喝到只剩四分之一,笔记本电量百分之十三——屏幕右下角那个小电池图标已经开始发烫。会议室投影上还卡着上轮需求评审的第12页,左边有道竖线,从“用户中心重构”标题一直拖到页脚,像一道没愈合的划痕。


  老板那天下午在茶水间拦住我,说:“首页要大气。”然后他拿手机点开竞品站,拇指在屏上划了三下,又收回去,没说话。设计把导航挪到了右上角,搜索框塞进折叠菜单第三层,原来的入口——就是原来 footer 里那个灰底白字的「API文档」链接——找不到了。没人提它,但第二天运维说监控告警炸了三次,全是 404,来源清一色是旧邮件模板里的跳转链接。我们没人去翻那封2019年发的EDM,只改了Nginx rewrite规则,在config.php里硬加了个兜底的header_location。


  我不是在讲PHP难。是讲:当你同时被三个活儿按在椅子上——后台系统补漏、活动站切包、还要给外包填H5里的埋点坑——结果发现某个接口返回的数据在curl里对、在Postman里对、在Chrome Network里错,但console.log(data)出来的却又是对的——这时候你不是缺工具,是缺一个不让你自己怀疑人生的确认锚点。


  所以这五条,不是“技巧”,是五次真实踩坑后、我掰开服务器日志、翻完Git blame、对着Wireshark抓包截图反复比对后,从指甲缝里抠出来的操作路径:


  第一,Xdebug配对失败?别死磕php.ini。直接去/var/log/apache2/error.log尾部 grep “xdebug”——去年2月14号那晚我找到一行:「Xdebug: [Step Debug] Could not connect to debugging client. Tried: localhost:9003 (through xdebug.client_host/xdebug.client_port)」。原来不是端口占用了,是Docker容器内网里根本没见过host.docker.internal这个host——改host映射比重装Xdebug快八分钟。


  第二,H5里JS调PHP接口时偶发空值?先别翻$_POST。打开Chrome DevTools → Network → 点那个XHR请求 → Headers → 看Request Payload是不是JSON格式。如果显示[object Object],说明前端没stringify;但如果你看见的是纯字符串,而PHP里$_POST还是空——那就是Content-Type写错了。我们上次遇到的,是Vue项目里axios默认发application/json,但后端只认application/x-www-form-urlencoded,连isset($_POST['a'])都绕不过去。后来我把后端那行if (!$_POST) die('')删了,改成file_get_contents('php://input')再json_decode——问题没了,但老板在晨会说“你这不规范”。我说:“规范救不了页面白屏。”他没接话。


  第三,本地测通了,线上报500?别急着看error_log。先ssh进去,cd到项目根目录,执行php -l index.php。没错,就这一个命令——语法检查。上周二,外包提交的代码里有个class末尾少了个},PHP-fpm不报错、nginx也不报错,只是随机崩。崩得毫无规律,崩得像玄学。我们花了四小时盯进程、看slowlog、查opcache,最后发现是php -l一跑就报错。桌上六瓶水,当时开了两瓶,我拧开第三瓶的时候才想起来敲这行。


  第四,var_dump太吵?别写echo '' . print_r($arr,1) . ''。在你的公共函数库里加个pp():function pp($v) { if (PHP_SAPI !== 'cli') header('Content-Type: text/plain'); print_r($v); exit; }——然后你在任何地方pp($_SESSION),它就会以纯文本吐出来,不触发HTML渲染链,不会和Vue的v-html打架,也不会让调试信息混进你本该返回的JSON里。那天下午走廊有人在大声打电话,声音震得会议室玻璃嗡嗡响,我就是靠着pp()在17秒内定位到session_start()前header已发送的问题。


  第五,真要查跨域或HTTPS混合内容?不要只看浏览器Console。开Safari(对,就它),用它的Web Inspector → Network → 在右侧Response Headers里手动展开“Access-Control-Allow-Origin”,看它是不是动态生成的。我们去年上线前最后一刻发现,某套旧CDN缓存规则把header缓存了12小时,导致CORS头明明改了,前端测不出。窗户那时被谁推开一半又关上,风带进来一点雨腥味——而我们就卡在那条header的TTL里,出不来。


  这些都不是“最佳实践”。是我在2月那周拆掉的三台测试机、重装的两次Composer、在git stash pop失败后手抄回来的六段代码、以及最后一次在会议纪要里写的那句:“请设计下次导出Sketch文件前,把图层命名统一为‘nav-main-01’而不是‘导航1’或‘top menu final’。”


  我没试过所有PHP调试插件,也没测过每种IDE的远程断点是否全兼容。手边这台MacBook Pro现在电量剩9%,风扇声有点大。接下来我要干的事很简单:把上面五条贴进我们组的共享Wiki,然后去找运维,让他把生产环境的display_errors=On关掉——至少等今晚这版活动页跑完A/B再关。别的,等明天晨会再说。

(编辑:站长网)

【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!