编辑“︁PHP错误日志”︁

= PHP错误日志 =

'''PHP错误日志'''是PHP运行时记录错误、警告和通知的系统工具，用于帮助开发者调试代码、监控应用程序状态并提高系统稳定性。错误日志可以记录语法错误、运行时错误、未定义变量等各类问题，是PHP应用程序维护的重要工具。

== 错误日志的基本概念 ==

PHP错误日志分为以下几种类型：
* '''系统日志'''：记录PHP引擎或服务器级别的错误（如内存不足、文件权限问题）
* '''应用程序日志'''：记录开发者通过<code>error_log()</code>函数手动写入的日志
* '''自定义日志'''：开发者通过文件操作或第三方库创建的独立日志文件

=== 错误级别 ===
PHP使用以下标准错误级别（按严重程度排序）：

<mermaid>
pie
    title PHP错误级别分布
    "E_ERROR" : 15
    "E_WARNING" : 25
    "E_PARSE" : 10
    "E_NOTICE" : 20
    "E_STRICT" : 5
    "其他" : 25
</mermaid>

数学表示错误级别权重：<math>Severity = \log_{10}(ErrorCode \times 2)</math>

== 配置错误日志 ==

=== php.ini配置 ===
主要配置参数：
<syntaxhighlight lang="ini">
; 开启错误日志
log_errors = On

; 指定日志文件路径
error_log = /var/log/php_errors.log

; 设置错误报告级别
error_reporting = E_ALL & ~E_NOTICE

; 是否在页面显示错误
display_errors = Off
</syntaxhighlight>

=== 运行时配置 ===
通过代码动态修改配置：
<syntaxhighlight lang="php">
// 设置错误报告级别
error_reporting(E_ALL | E_STRICT);

// 自定义日志路径
ini_set('error_log', '/path/to/custom_errors.log');

// 关闭HTML错误显示
ini_set('display_errors', '0');
</syntaxhighlight>

== 记录错误日志 ==

=== 自动记录 ===
PHP会自动记录符合当前错误报告级别的错误：
<syntaxhighlight lang="php">
// 会产生一个警告并被记录
$file = fopen("nonexistent.txt", "r");
</syntaxhighlight>

示例日志条目：
<pre>
[2023-08-20 14:30:45] WARNING: fopen(nonexistent.txt): failed to open stream: No such file or directory in /path/to/script.php on line 2
</pre>

=== 手动记录 ===
使用<code>error_log()</code>函数：
<syntaxhighlight lang="php">
// 记录简单消息
error_log("用户登录失败: 用户名admin");

// 记录到系统日志
error_log("数据库连接超时", 0);

// 发送邮件通知
error_log("紧急: 服务器磁盘空间不足", 1, "admin@example.com");

// 记录到自定义文件
error_log("[API] 无效的请求参数\n", 3, "/var/log/api_errors.log");
</syntaxhighlight>

== 日志格式分析 ==

典型日志条目包含以下部分：
1. 时间戳（格式可配置）
2. 错误级别
3. 错误消息
4. 错误发生的文件路径
5. 错误行号

示例结构：
<mermaid>
flowchart LR
    A[时间戳] --> B[错误级别]
    B --> C[错误消息]
    C --> D[文件路径]
    D --> E[行号]
</mermaid>

== 高级用法 ==

=== 自定义日志处理器 ===
创建自定义错误处理函数：
<syntaxhighlight lang="php">
function customErrorHandler($errno, $errstr, $errfile, $errline) {
    $logEntry = sprintf("[%s] [%s] %s (%s:%d)\n",
        date('Y-m-d H:i:s'),
        $errno,
        $errstr,
        $errfile,
        $errline
    );
    
    // 写入自定义日志文件
    file_put_contents('/var/log/custom_php_errors.log', $logEntry, FILE_APPEND);
    
    // 阻止PHP默认错误处理
    return true;
}

set_error_handler("customErrorHandler");
</syntaxhighlight>

=== 日志轮转 ===
处理大型应用程序的日志文件：
<syntaxhighlight lang="php">
// 简单的日志轮转实现
if (filesize('/var/log/php_errors.log') > 1024 * 1024) {
    rename('/var/log/php_errors.log', '/var/log/php_errors_' . date('Y-m-d') . '.log');
    touch('/var/log/php_errors.log');
}
</syntaxhighlight>

== 实际案例 ==

=== 案例1：调试表单提交问题 ===
<syntaxhighlight lang="php">
// 在表单处理脚本开头启用详细日志
error_reporting(E_ALL);
ini_set('display_errors', 0);
ini_set('log_errors', 1);

// 记录表单数据
error_log("表单提交数据: " . print_r($_POST, true));

// 业务逻辑处理...
if (empty($_POST['username'])) {
    error_log("表单验证失败: 用户名不能为空");
    // ...
}
</syntaxhighlight>

=== 案例2：监控API性能 ===
<syntaxhighlight lang="php">
// API入口脚本
$startTime = microtime(true);

// ...API处理逻辑...

$responseTime = microtime(true) - $startTime;
if ($responseTime > 2) { // 超过2秒视为慢请求
    error_log(sprintf("慢API请求: %s 耗时 %.3f秒", $_SERVER['REQUEST_URI'], $responseTime));
}
</syntaxhighlight>

== 最佳实践 ==

1. '''生产环境'''：关闭<code>display_errors</code>，只记录日志
2. '''开发环境'''：开启<code>display_errors</code>并设置为<code>E_ALL</code>
3. 定期'''检查日志文件'''权限（确保web服务器有写入权限）
4. 实现'''日志轮转'''策略防止日志文件过大
5. 对敏感信息进行'''脱敏处理'''（如密码、信用卡号等）
6. 考虑使用'''专业日志系统'''（如ELK、Graylog等）处理大规模应用

== 常见问题 ==

'''Q: 为什么我的错误没有记录到日志中？'''
A: 检查以下方面：
* 确保<code>log_errors</code>设置为On
* 确认<code>error_log</code>路径可写
* 验证当前错误级别包含所发生的错误类型
* 检查磁盘空间是否充足

'''Q: 如何记录PHP致命错误？'''
A: 使用<code>register_shutdown_function()</code>配合<code>error_get_last()</code>：
<syntaxhighlight lang="php">
register_shutdown_function(function() {
    $error = error_get_last();
    if ($error && in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR])) {
        error_log("致命错误: " . print_r($error, true));
    }
});
</syntaxhighlight>

== 总结 ==
PHP错误日志是应用程序监控和调试的重要工具。合理配置错误报告级别、选择适当的日志存储方式，并建立规范的日志分析流程，可以显著提高应用程序的可靠性和可维护性。对于关键业务系统，建议将PHP日志集成到统一的日志管理系统中，实现更专业的日志分析和告警功能。

[[Category:编程语言]]
[[Category:PHP]]
[[Category:PHP错误与异常处理]]