“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 版本与服务器配置调整;涉及生产环境的变更,建议先备份并在测试环境验证。