PHP原生代码怎么写一个完整的自定义错误处理类-php教程-PHP中文网

不能仅用 set_error_handler，因为它不捕获 e_error 等致命错误；完整方案需同时注册 set_error_handler、set_exception_handler 和 register_shutdown_function。

php原生代码怎么写一个完整的自定义错误处理类

为什么不能直接用 `set_error_handler` 就完事？

因为 set_error_handler 只捕获 E_WARNING、E_NOTICE 这类非终止错误，而 E_ERROR、E_PARSE 等致命错误它根本收不到——这些会直接中断脚本。真正“完整”的自定义错误处理，必须同时接管错误（set_error_handler）、异常（set_exception_handler）和致命错误（register_shutdown_function + error_get_last()）。

常见错误现象：写了 set_error_handler 却发现 500 页面还是没日志、没友好的提示页，就是漏了致命错误兜底。

PHP 7+ 中 E_ERROR 不再触发 set_error_handler，必须靠 shutdown 函数捞
set_exception_handler 不处理错误，只处理未捕获的 Exception 和 Error（PHP 7 的 Error 是 Throwable 子类）
多个 handler 注册时后注册的会覆盖前一个，需确保只注册一次

怎么组织一个可复用的 `ErrorHandler` 类？

核心是把三类入口统一收敛到一个类里，用静态方法初始化，避免全局污染。关键不是“写得多”，而是“分得清”：哪些该记录，哪些该响应，哪些必须立刻中止。

示例骨架：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

class ErrorHandler
{
    public static function register(): void
    {
        set_error_handler([self::class, 'handleError']);
        set_exception_handler([self::class, 'handleException']);
        register_shutdown_function([self::class, 'handleShutdown']);
    }

    public static function handleError(int $level, string $message, string $file, int $line): bool
    {
        // 处理 E_WARNING/E_NOTICE 等
        error_log("PHP Error: [$level] $message in $file:$line");
        return false; // 返回 false 表示不屏蔽原生错误输出（开发环境可留，生产建议 true）
    }

    public static function handleException(Throwable $e): void
    {
        error_log("Uncaught Exception: " . $e->getMessage() . " in " . $e->getFile() . ":" . $e->getLine());
        http_response_code(500);
        echo "系统繁忙，请稍后再试";
    }

    public static function handleShutdown(): void
    {
        if ($error = error_get_last()) {
            if (in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_USER_ERROR])) {
                error_log("Fatal Error: {$error['message']} in {$error['file']}:{$error['line']}");
                http_response_code(500);
                echo "系统繁忙，请稍后再试";
            }
        }
    }
}

handleError 返回 false 才会让 PHP 继续抛出原始错误（方便开发调试），生产环境建议返回 true 屏蔽
handleException 必须接收 Throwable，兼容 Exception 和 PHP 7+ 的 Error
handleShutdown 里只处理致命错误类型，避免把 exit() 或正常结束误判为错误

如何让错误响应更可控？比如区分开发/生产环境

硬编码 echo 或 error_log 不够灵活。应该把“记录”和“响应”解耦，用配置驱动行为。

加一个 $isDev 属性，开发环境显示详细错误（debug_backtrace()），生产环境只打日志+返回通用提示
把日志写入改为调用 error_log($msg, 3, $logFile)，避免依赖 syslog 或第三方
HTTP 响应状态码别写死：对 E_USER_DEPRECATED 用 400，E_ERROR 用 500，Exception 根据类型判断（如 InvalidArgumentException 用 400）
避免在 handler 中触发新错误（比如尝试写入不可写的日志目录），会导致二次崩溃