PHP Academy · 课时

PHP 错误类型与报告

Q: 「PHP 错误类型与报告」这节课中我会学到什么？

了解通知、警告和致命错误，以及 error_reporting 的级别。 你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

了解通知、警告和致命错误，以及 error_reporting 的级别。

PHP 错误类型与报告 是 CoddyKit 上的免费 PHP Academy 课时。这是第 1 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 PHP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 PHP Academy 课程共包含 4 节课。

PHP 错误类型

PHP 有多个严重程度不同的错误级别：

通知 — 轻微问题，执行会继续
警告 — 非致命问题，执行会继续
致命错误 — 执行立即停止
解析错误 — 语法错误，在执行前停止
已弃用 — 该功能将被移除

error_reporting()

使用 error_reporting() 控制 PHP 报告哪些错误：

<?php
// Show all errors (development)
error_reporting(E_ALL);

// Hide notices and deprecated
error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED);

// Production: no display, log to file
error_reporting(E_ALL);
ini_set('display_errors', '0');
ini_set('log_errors', '1');
ini_set('error_log', '/var/log/php_errors.log');

display_errors 与 log_errors

错误处理相关的关键 php.ini 设置：

display_errors = On — 在浏览器中显示错误（仅限开发环境）
display_errors = Off — 对用户隐藏错误（生产环境）
log_errors = On — 将错误写入 error_log 文件
error_log = /path/to/file — 指定日志位置

在生产环境中，绝不要向用户显示错误！

使用 trigger_error 触发错误

使用 trigger_error() 生成您自己的 PHP 错误：

<?php
function divide(int $a, int $b): float {
    if ($b === 0) {
        trigger_error('Division by zero', E_USER_WARNING);
        return 0.0;
    }
    return $a / $b;
}

echo divide(10, 0);  // triggers E_USER_WARNING

自定义错误处理器

使用 set_error_handler() 注册您自己的错误处理器：

<?php
set_error_handler(function(int $errno, string $errstr, string $file, int $line): bool {
    $message = "[$errno] $errstr in $file:$line";
    error_log($message);
    if ($errno === E_USER_ERROR) {
        http_response_code(500);
        die('Internal error — please try again later');
    }
    return true;  // don't execute PHP internal error handler
});

trigger_error('Custom error message', E_USER_ERROR);

常见错误来源

PHP 错误的典型原因：

访问未定义的数组键 → 通知
调用返回 false 的函数，然后使用其结果 → 警告
调用未定义的函数 → 致命错误
缺少分号 → 解析错误
除以零 → 警告（返回 INF 或 NAN）

错误抑制运算符 @

@ 运算符会抑制单个表达式产生的错误 — 应避免使用它，并采用恰当的错误处理：

<?php
// Bad: hides errors silently
$result = @file_get_contents('missing.txt');

// Good: check explicitly
$result = file_get_contents('missing.txt');
if ($result === false) {
    // handle the error
    echo 'File not found';
}

PHP 8 JIT 与错误处理变更

PHP 8 使错误处理更加严格：

许多警告会提升为 TypeError/ValueError
使用 str_contains/starts_with/ends_with 替代正则表达式来进行简单检查
默认情况下，传入错误的参数类型会抛出 TypeError

运行时使用 ini_set

在运行时覆盖 php.ini 设置：

<?php
// Display errors during development
if (getenv('APP_ENV') === 'development') {
    ini_set('display_errors', '1');
    ini_set('display_startup_errors', '1');
    error_reporting(E_ALL);
} else {
    ini_set('display_errors', '0');
    ini_set('log_errors', '1');
    error_reporting(E_ALL);
}

检查错误级别

使用按位 AND 检测错误级别：

<?php
$level = error_reporting();

if ($level & E_NOTICE) {
    echo 'Notices are reported';
}
if ($level & E_WARNING) {
    echo 'Warnings are reported';
}

// Check specific error types
echo (E_ALL & E_NOTICE) ? 'E_ALL includes E_NOTICE' : 'no';

错误日志记录最佳实践

良好的错误日志记录习惯：

始终在生产环境中记录错误
包含上下文信息：用户 ID、请求 URL、时间戳
使用结构化日志记录（JSON），以便更轻松地解析
轮换日志文件，防止磁盘空间耗尽
使用 ELK、Datadog 或 Papertrail 等工具监控日志

快速检查

哪种 PHP 错误类型会立即停止执行？

回顾：PHP 错误报告

错误处理要点：

错误类型：通知、警告、致命错误、解析错误、已弃用
使用 error_reporting() 设置级别
生产环境中关闭显示并开启日志记录
使用 set_error_handler() 注册自定义处理器
在生产代码中绝不要使用 @ 抑制错误

常见问题解答

「PHP 错误类型与报告」课时是免费的吗？

是的 — 「PHP 错误类型与报告」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 PHP Academy 课程的其余内容，请升级到 CoddyKit PRO。 PHP Academy 课程共包含 4 节课。

「PHP 错误类型与报告」这节课中我会学到什么？

了解通知、警告和致命错误，以及 error_reporting 的级别。你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 PHP Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 PHP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 1 节课，共 4 节。

「PHP 错误类型与报告」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 PHP Academy 课中编写并运行代码吗？

能。每节 PHP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 PHP Academy