“Notice 不影响运行,关掉就行”——这句话坑了很多人。Notice 往往预示着变量名拼错、数组键不存在这类真实 bug,关掉之后它会在某个关键时刻变成 500。
错误级别速查
| 级别 | 含义 | 处理建议 |
|---|---|---|
E_ERROR |
致命错误,脚本终止 | 必须修 |
E_WARNING |
警告,脚本继续 | 必须修 |
E_NOTICE |
提示,可能是笔误 | 开发环境显示,生产环境记日志 |
E_DEPRECATED |
特性将被移除 | 升级前必须清理 |
E_STRICT |
编码规范建议(PHP 8 已并入 E_ALL) | 参考 |
推荐的两套配置
; 开发环境
display_errors = On
display_startup_errors = On
error_reporting = E_ALL
log_errors = On
; 生产环境
display_errors = Off
error_reporting = E_ALL & ~E_DEPRECATED & ~E_NOTICE
log_errors = On
log_errors_max_len = 0
error_log = /var/log/php/error.log
注意生产环境是”不显示”而不是”不记录”。display_errors = Off 避免错误信息泄露路径与 SQL,但日志必须完整保留,否则出问题无从查起。
自定义错误处理器
框架通常会把 Warning 转成异常,这样能统一处理。自己写项目也可以这么做:
<?php
set_error_handler(function ($errno, $errstr, $errfile, $errline) {
if (!(error_reporting() & $errno)) {
return false; // 被 @ 抑制的错误不处理
}
throw new ErrorException($errstr, 0, $errno, $errfile, $errline);
});
set_exception_handler(function ($e) {
error_log(sprintf("[%s] %s in %s:%dn%s",
get_class($e), $e->getMessage(), $e->getFile(), $e->getLine(), $e->getTraceAsString()));
http_response_code(500);
echo '服务暂时不可用,请稍后再试。';
});
关于 @ 抑制符
@ 会吞掉错误,但代价是掩盖真实问题,而且有性能开销。只在明确知道会失败且已处理的情况下使用,比如 @unlink($file) 前已经 file_exists 判断过。
升级时的 E_DEPRECATED
从 PHP 7.4 升到 8.x 时,把 E_DEPRECATED 打开跑一遍全站,能提前发现大量兼容问题:动态属性、可选参数顺序、null 传给非空参数等。这一步比升级后再救火省事得多。
本文为 PHP 学习与排错的经验整理。示例代码以通用环境为前提,请结合自身 PHP 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。