写给愿意动手的 PHP 开发者
PHP学习网 PHP学习网
公告PHP学习网为公益性网站,致力于为广大PHP爱好者服务
首页/ PHP 教程/ 工程化/ 错误、异常与日志:出问题时能查
工程化 异常错误处理日志

错误、异常与日志:出问题时能查

Error 与 Exception 的区别、set_error_handler 与 set_exception_handler、自定义异常分层、日志该记什么。

PHP 里「错误」和「异常」是两套机制。Error 是引擎层面的问题(类型错误、调用不存在的方法),Exception 是业务代码主动抛出的。PHP 7 起两者都实现 Throwable,可以统一 catch。

三处必须设置

PHP
<?php
// 1. 开发显示,生产记录
error_reporting(E_ALL);
ini_set('display_errors', '0');
ini_set('log_errors', '1');
ini_set('error_log', __DIR__ . '/logs/php-error.log');

// 2. 把警告转成异常,避免静默失败
set_error_handler(function ($no, $str, $file, $line) {
    if (!(error_reporting() & $no)) return false;
    throw new ErrorException($str, 0, $no, $file, $line);
});

// 3. 兜底:未捕获的异常写日志并返回 500
set_exception_handler(function (Throwable $e) {
    error_log(sprintf("[%s] %s in %s:%d\n%s", date('c'), $e->getMessage(), $e->getFile(), $e->getLine(), $e->getTraceAsString()));
    http_response_code(500);
    echo '服务暂时不可用,请稍后重试。';
});

把警告转异常是关键一步。默认情况下,未定义变量只是一个 Warning,脚本继续跑,最后得到一堆 null——这种 bug 最难查。

自定义异常分层

业务异常和系统异常要分开:前者是「用户输入不对」,返回 400 并提示具体原因;后者是「代码或环境出问题」,返回 500 并隐藏细节。

PHP
class ValidationException extends RuntimeException {}
class NotFoundException extends RuntimeException {}

try {
    $order = $repo->find($id);
} catch (NotFoundException $e) {
    http_response_code(404);
    exit('订单不存在');
}

捕获时要具体,不要一个 catch (Throwable) 把所有异常都吞掉。吞掉异常等于把线索扔了。

日志记什么

一条有用的日志至少包含:时间、级别、请求 ID、用户 ID、消息、上下文(关键参数)、异常堆栈。级别用 debug/info/warning/error 区分,别全用 error。

敏感信息要脱敏:密码、手机号、身份证、支付单号。日志文件本身也要限制访问权限,别放在 Web 根目录下。

一个习惯:每个请求生成一个 request_id,在响应头里返回,用户报错时让他提供这个 ID,你能直接定位到那一条日志。

文中提到的函数

接着读