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

蓮花仙者

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

430人浏览过

来源于php中文网

原创

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()
```
函数:

这种方式允许你在脚本级别控制错误报告。例如，如果你只想在某个特定的脚本中报告所有错误，可以使用以下代码：
```
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

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

奇布塔

基于AI生成技术的一站式有声绘本创作平台

下载

查找已弃用的功能:

启用
```
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 "My ERROR [$errno] $errstr
\n";
            echo "  Fatal error on line $errline in file $errfile";
            echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")
\n";
            echo "Aborting...
\n";
            exit(1);
            break;

        case E_USER_WARNING:
            echo "My WARNING [$errno] $errstr
\n";
            break;

        case E_USER_NOTICE:
            echo "My NOTICE [$errno] $errstr
\n";
            break;

        default:
            echo "Unknown error type: [$errno] $errstr
\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]);
        // 处理异常
    }
}

框架提供的错误处理机制可以简化错误处理的过程，并提供更多的功能，例如错误报告、异常跟踪等。

如何监控和定位 PHP 脚本中导致响应延迟的阻塞操作（如 sleep()）

php数据库怎么进用框架yii进_phpYii连库法【教程】

php创建数据库跨服务器可行吗_php远程建库条件与法【方案】

php格式文件打开是空白页咋整_php空白页排查教程【技巧】

php如何动态获取数组下标_php动态下标获取技巧【教程】