什么是PHP的错误级别？如何配置error_reporting调试-php教程-PHP中文网

什么是PHP的错误级别？如何配置error_reporting调试

蓮花仙者

发布： 2025-09-05 16:01:02

原创

402人浏览过

PHP错误级别定义了错误的严重程度，如E_ERROR为致命错误，E_WARNING为非致命警告，E_NOTICE为通知；通过error_reporting配置可控制显示哪些级别错误，结合display_errors和log_errors可实现开发环境显示错误、生产环境记录日志；使用E_ALL报告所有错误，配合自定义错误处理函数set_error_handler和框架内置机制（如Laravel、Symfony的Monolog）可提升调试效率；E_DEPRECATED提示使用了弃用功能，需参考文档迁移；错误日志包含时间、文件、行号等信息，利于定位问题，可借助Logstash等工具分析。

什么是php的错误级别？如何配置error_reporting调试

PHP的错误级别定义了哪些类型的错误会被报告，而

error_reporting

登录后复制

指令则控制着哪些级别的错误会被实际显示出来。配置

error_reporting

登录后复制

对于调试至关重要，因为它能帮助你定位代码中的问题。

不同的错误级别代表了不同严重程度的问题，从无关紧要的通知到致命的错误。

PHP错误报告配置与调试

如何理解PHP的错误级别？

PHP定义了多个错误级别，每个级别代表不同类型的错误。理解这些级别是有效配置错误报告的基础。以下是一些常见的错误级别：

立即学习“PHP免费学习笔记（深入）”；

```
E_ERROR
```
登录后复制
: 致命的运行时错误。脚本终止执行。
```
E_WARNING
```
登录后复制
: 运行时警告（非致命错误）。脚本继续执行。
```
E_PARSE
```
登录后复制
: 编译时语法解析错误。
```
E_NOTICE
```
登录后复制
: 运行时通知。可能是错误，也可能不是，通常是未定义的变量。
```
E_CORE_ERROR
```
登录后复制
: PHP启动时发生的致命错误。
```
E_CORE_WARNING
```
登录后复制
: PHP启动时发生的警告（非致命错误）。
```
E_COMPILE_ERROR
```
登录后复制
: 编译时致命错误。
```
E_COMPILE_WARNING
```
登录后复制
: 编译时警告。
```
E_USER_ERROR
```
登录后复制
: 用户自定义的错误消息。
```
E_USER_WARNING
```
登录后复制
: 用户自定义的警告消息。
```
E_USER_NOTICE
```
登录后复制
: 用户自定义的通知消息。
```
E_STRICT
```
登录后复制
: 建议级别的错误，帮助你编写更好的代码。
```
E_RECOVERABLE_ERROR
```
登录后复制
: 可捕获的致命错误。
```
E_DEPRECATED
```
登录后复制
: 提示代码中使用了已弃用的功能。
```
E_USER_DEPRECATED
```
登录后复制
: 用户触发的已弃用警告。
```
E_ALL
```
登录后复制
: 除了
```
E_STRICT
```
登录后复制
之外的所有错误。在PHP 5.4.0之后，
```
E_ALL
```
登录后复制
包含
```
E_STRICT
```
登录后复制
。

理解这些错误级别，能让你更精确地控制哪些错误会被报告，从而更有效地进行调试。

如何配置

error_reporting

登录后复制

？

配置

error_reporting

登录后复制

有几种方式，包括在

php.ini

登录后复制

文件中设置，或者在PHP脚本中使用

error_reporting()

登录后复制

函数。

在
```
php.ini
```
登录后复制
中配置:

找到你的
```
php.ini
```
登录后复制
文件（可以使用
```
phpinfo()
```
登录后复制
函数来查找），然后修改
```
error_reporting
```
登录后复制
指令。例如，要报告所有错误，可以将该指令设置为
```
E_ALL
```
登录后复制
。
```
error_reporting = E_ALL
```
登录后复制
修改后，需要重启Web服务器才能使配置生效。
在PHP脚本中使用
```
error_reporting()
```
登录后复制
函数:

这种方式允许你在脚本级别控制错误报告。例如，如果你只想在某个特定的脚本中报告所有错误，可以使用以下代码：
```
<?php
error_reporting(E_ALL);
ini_set('display_errors', 1); // 确保错误显示在浏览器中，仅用于开发环境

// 你的代码
?>
```
登录后复制
```
ini_set('display_errors', 1)
```
登录后复制
这行代码也很重要，它确保错误信息会被输出到浏览器。注意，在生产环境中，强烈建议关闭
```
display_errors
```
登录后复制
，并将错误信息记录到日志文件中。
常用的配置示例:
- 开发环境:
```
error_reporting(E_ALL); ini_set('display_errors', 1);
```
  登录后复制
  报告所有错误，并显示在浏览器中。
- 生产环境:
```
error_reporting(E_ERROR | E_WARNING | E_PARSE); ini_set('display_errors', 0); ini_set('log_errors', 1); ini_set('error_log', '/path/to/php_errors.log');
```
  登录后复制
  只报告严重的错误，不显示在浏览器中，而是记录到日志文件中。

如何利用错误日志进行调试？

在生产环境中，将错误信息记录到日志文件是最佳实践。这不仅可以避免向用户暴露敏感信息，还可以帮助你追踪和解决问题。

配置错误日志:

在
```
php.ini
```
登录后复制
文件中，设置
```
log_errors
```
登录后复制
为
```
On
```
登录后复制
，并指定
```
error_log
```
登录后复制
文件的路径。
```
log_errors = On
error_log = /var/log/php_errors.log
```
登录后复制
同样，修改后需要重启Web服务器。
分析错误日志:

定期检查错误日志文件，查找错误、警告和通知。错误日志通常包含错误发生的时间、文件、行号和错误消息。利用这些信息，可以快速定位到代码中的问题。

例如，一个典型的错误日志条目可能如下所示：
```
[2023-10-27 10:00:00 UTC] PHP Warning:  Undefined variable $name in /var/www/html/index.php on line 10
```
登录后复制
这个条目告诉你，在
```
/var/www/html/index.php
```
登录后复制
文件的第10行，有一个未定义的变量
```
$name
```
登录后复制
。
使用工具分析日志:

对于大型项目，手动分析错误日志可能很耗时。可以使用一些工具来自动分析日志文件，例如Logstash、Graylog等。这些工具可以帮助你过滤、聚合和可视化错误日志，从而更快地发现问题。

如何处理

E_DEPRECATED

登录后复制

错误？

E_DEPRECATED

登录后复制

错误提示你代码中使用了已弃用的功能。虽然这些功能仍然可以工作，但将来可能会被移除。因此，最好尽快替换掉这些已弃用的功能。

PPT.CN,PPTCN,PPT.CN是什么,PPT.CN官网,PPT.CN如何使用

一键操作，智能生成专业级PPT

查看详情

查找已弃用的功能:

启用
```
E_DEPRECATED
```
登录后复制
错误报告，然后运行你的代码。PHP会输出所有已弃用的功能。
```
error_reporting(E_ALL);
ini_set('display_errors', 1);
```
登录后复制
替换已弃用的功能:

查阅PHP官方文档，找到替代已弃用功能的建议。通常，PHP文档会提供详细的迁移指南。

例如，如果你的代码使用了
```
mysql_connect()
```
登录后复制
函数（已弃用），你应该替换为
```
mysqli_connect()
```
登录后复制
或PDO。
逐步迁移:

一次性替换所有已弃用的功能可能很困难。可以逐步迁移，每次替换一个或几个功能。在替换后，进行充分的测试，确保代码仍然可以正常工作。

如何自定义错误处理？

PHP允许你自定义错误处理函数，以便更灵活地处理错误。你可以使用

set_error_handler()

登录后复制

函数来注册你自己的错误处理函数。

定义错误处理函数:

创建一个函数，该函数接收五个参数：错误级别、错误消息、文件名、行号和上下文。

function myErrorHandler($errno, $errstr, $errfile, $errline, $errcontext) {
    // 根据错误级别进行处理
    switch ($errno) {
        case E_USER_ERROR:
            echo "<b>My ERROR</b> [$errno] $errstr<br />\n";
            echo "  Fatal error on line $errline in file $errfile";
            echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />\n";
            echo "Aborting...<br />\n";
            exit(1);
            break;

        case E_USER_WARNING:
            echo "<b>My WARNING</b> [$errno] $errstr<br />\n";
            break;

        case E_USER_NOTICE:
            echo "<b>My NOTICE</b> [$errno] $errstr<br />\n";
            break;

        default:
            echo "Unknown error type: [$errno] $errstr<br />\n";
            break;
    }

    // 不要执行PHP内部的错误处理程序
    return true;
}

登录后复制

注册错误处理函数:

使用
```
set_error_handler()
```
登录后复制
函数来注册你的错误处理函数。
```
set_error_handler("myErrorHandler");
```
登录后复制

触发用户错误:

使用

trigger_error()

登录后复制

函数来触发用户错误。

if (empty($username)) {
    trigger_error("Username is required", E_USER_WARNING);
}

登录后复制

通过自定义错误处理，你可以更好地控制错误的显示方式，并将错误信息记录到数据库或其他地方。

如何在框架中使用错误处理？

大多数PHP框架（例如Laravel、Symfony）都提供了自己的错误处理机制。这些框架通常会自动注册错误处理函数，并将错误信息记录到日志文件中。

Laravel:

Laravel使用Monolog来记录错误。你可以在
```
config/logging.php
```
登录后复制
文件中配置日志通道。默认情况下，Laravel会将错误信息记录到
```
storage/logs/laravel.log
```
登录后复制
文件中。

你还可以使用
```
try-catch
```
登录后复制
块来捕获异常，并使用
```
report()
```
登录后复制
方法将异常报告给日志系统。
```
try {
    // 你的代码
} catch (Exception $e) {
    report($e); // 将异常报告给日志系统
    // 处理异常
}
```
登录后复制
Symfony:

Symfony使用Monolog来记录错误。你可以在
```
config/packages/monolog.yaml
```
登录后复制
文件中配置日志处理器。默认情况下，Symfony会将错误信息记录到
```
var/log/dev.log
```
登录后复制
和
```
var/log/prod.log
```
登录后复制
文件中。

你还可以使用
```
try-catch
```
登录后复制
块来捕获异常，并使用
```
$logger->error()
```
登录后复制
方法将错误信息记录到日志文件中。
```
use Psr\Log\LoggerInterface;

public function index(LoggerInterface $logger)
{
    try {
        // 你的代码
    } catch (\Exception $e) {
        $logger->error($e->getMessage(), ['exception' => $e]);
        // 处理异常
    }
}
```
登录后复制