文章资讯 / 常见问题 / PHP报错排查入门:从白屏到修复的完整路径

PHP报错排查入门:从白屏到修复的完整路径

发布时间: 分类:常见问题 作者:188mi 来源:www.jianshu.com,blog.csdn.net,php.cn 阅读:25
先说一个PHP开发最恐怖的场景:改了一行代码,保存,刷新页面——白屏。没有报错信息、没有提示——就是一片空白。你不知道哪里错了,从哪里开始查。别慌——PHP的报错排查有固定路径:开错误显示、看错误日志、按错误类型修复。这篇按这三步走。

第一步:让错误显示出来白屏的原因:PHP的默认配置把错误显示关了(display_errors = Off)——出错时直接输出空白。开发环境开启错误显示:在PHP文件开头加 ini_set('display_errors', 1); error_reporting(E_ALL);——刷新页面就能看到具体的错误信息了。或者在php.ini中全局设置 display_errors = On。生产环境不要开display_errors(安全风险)——而是看错误日志:error_log = /var/log/php/error.log——所有错误写入日志文件。快速区分:开发环境开display_errors(页面直接看错误),生产环境看error_log(日志文件里看)。

第二步:读懂常见的PHP错误类型看到错误信息后——按类型分类处理。Parse Error(语法错误)——如 syntax error, unexpected ';'——PHP代码语法有问题——少了个分号、多了个括号。修法:看错误行号——直接去改语法。Fatal Error(致命错误)——如 Call to undefined function xxx()——调用了不存在的函数——函数名拼错了或者对应的扩展没装。修法:检查函数名拼写、确认PHP扩展已安装。Warning(警告)——如 Undefined variable: xxx——使用了未定义的变量——不致命但说明代码有逻辑问题。修法:在变量使用前先初始化。Notice(通知)——如 Undefined index: xxx——访问了数组中不存在的键。修法:先用isset()检查。Deprecated(弃用警告)——使用了PHP新版本中已弃用的函数——如mysql_connect()在PHP7中被移除。修法:换用推荐的替代函数(如mysqli或PDO)。

第三步:五个最高频的PHP错误和修法错误一:Maximum execution time exceeded——脚本执行超时(默认30秒)——死循环或代码效率太低。修法:排查循环逻辑有没有死循环;确实需要长时间执行的用 set_time_limit(0) 放宽。错误二:Allowed memory size exhausted——内存不足(默认128M)——处理了过大的数据集。修法:优化代码减少内存占用(分批处理大数据);确实需要更多内存的在php.ini中调大memory_limit。错误三:Call to undefined function curl_init()——curl扩展没装。修法:安装php-curl扩展——apt install php-curl 或 yum install php-curl。错误四:Headers already sent by——在header()调用之前已经有输出——HTML内容、空行、BOM都有可能。修法:确保header()调用在任何输出之前;检查文件开头有没有多余的空行或BOM。错误五:Permission denied——文件或目录没有写入权限。修法:chmod 755 目录或 chmod 644 文件——PHP进程的用户需要有对应的读写权限。

第四步:环境问题 vs 代码问题PHP报错的原因分为两类——修法完全不同:环境问题——PHP版本不对(代码用了新版本语法但服务器是老版本)、扩展缺失(curl/gd/mbstring没装)、配置限制(memory_limit太小、max_execution_time太短)。代码问题——语法错误、逻辑错误、变量未定义、数组越界。快速判断:错误信息里有extension或function undefined→环境问题(装扩展、升级版本);有syntax error或undefined variable→代码问题(改代码)。环境问题的修法通常是运维操作(安装配置),代码问题的修法是改代码——区分清楚才能找对人修。

调试工具推荐var_dump()和print_r()——最基础也最常用的调试工具——输出变量的值和结构——在关键位置插入查看变量状态。error_log()——把调试信息写入错误日志——不影响页面输出——生产环境也能安全使用。Xdebug——PHP专业调试扩展——断点调试、堆栈跟踪、性能分析——开发环境的神器。三个工具按需求选:快速看变量用var_dump,生产环境用error_log,深度调试用Xdebug。按类型修就对了。