怎么用 mysqli::$error 和 error_log() 把数据库错误记录到日志文件中？

M66 2025-07-01

怎么用 mysqli::$error 和 error_log() 把数据库错误记录到日志文件中？

在开发 PHP 应用程序时，数据库错误处理是不可避免的一部分。为了更好地排查和调试问题，及时记录数据库错误是非常必要的。PHP 中的 mysqli 扩展提供了一个非常实用的属性 mysqli::$error，它可以让你获取数据库连接中的最后一个错误信息。结合 PHP 内置的 error_log() 函数，可以将错误信息记录到日志文件中，帮助开发者在生产环境中追踪问题。

本文将介绍如何使用 mysqli::$error 和 error_log() 来记录 MySQL 数据库的错误信息，并且将错误日志保存在指定的文件中，确保开发者能够及时发现并修复问题。

1. 获取 MySQL 错误信息

在使用 mysqli 扩展连接 MySQL 数据库时，发生任何 SQL 执行错误时，错误信息都会通过 mysqli::$error 属性提供。这个属性会返回上一个数据库操作（如查询、更新、插入等）的错误信息。需要注意的是，mysqli::$error 只会返回最近一个操作的错误消息，如果没有错误，它会返回一个空字符串。

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$mysqli</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title function_ invoke__">mysqli</span></span><span>(</span><span><span class="hljs-string">"localhost"</span></span><span>, </span><span><span class="hljs-string">"root"</span></span><span>, </span><span><span class="hljs-string">"password"</span></span><span>, </span><span><span class="hljs-string">"test_db"</span></span><span>);

</span><span><span class="hljs-comment">// 检查连接是否成功</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"连接失败: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error);
}

</span><span><span class="hljs-comment">// 执行一条故意出错的 SQL 查询</span></span><span>
</span><span><span class="hljs-variable">$query</span></span><span> = </span><span><span class="hljs-string">"SELECT * FROM non_existing_table"</span></span><span>;
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">query</span></span><span>(</span><span><span class="hljs-variable">$query</span></span><span>);

</span><span><span class="hljs-comment">// 检查查询是否执行成功</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-variable">$result</span></span><span>) {
    </span><span><span class="hljs-comment">// 获取并输出错误信息</span></span><span>
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"错误信息: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;error;
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在上面的代码中，当查询不存在的表时，$mysqli->error 会返回 MySQL 的错误信息，例如“Table 'test_db.non_existing_table' doesn't exist”。

2. 使用 error_log() 记录错误到日志文件

error_log() 函数是 PHP 提供的一个非常方便的工具，用于将错误信息写入日志文件或发送到指定的错误日志处理程序。通过结合 mysqli::$error 和 error_log()，我们可以将数据库错误记录到一个日志文件中，供日后排查和分析。

error_log() 函数的基本用法是：

<span><span><span class="hljs-title function_ invoke__">error_log</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$message</span></span><span>, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$message_type</span></span><span> = </span><span><span class="hljs-number">0</span></span><span>, </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$destination</span></span><span> = ?, </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$extra_headers</span></span><span> = ?)
</span></span>

$message: 要记录的错误信息。
$message_type: 错误日志类型。0 表示记录到 PHP 的错误日志文件，1 表示发送邮件，2 表示发送到某个文件。
$destination: 如果 $message_type 为 1 或 2，则指定接收邮件的地址或日志文件路径。

下面是一个示例，展示如何将 mysqli::$error 中的错误信息写入到一个日志文件：

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-variable">$mysqli</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title function_ invoke__">mysqli</span></span><span>(</span><span><span class="hljs-string">"localhost"</span></span><span>, </span><span><span class="hljs-string">"root"</span></span><span>, </span><span><span class="hljs-string">"password"</span></span><span>, </span><span><span class="hljs-string">"test_db"</span></span><span>);

</span><span><span class="hljs-comment">// 检查连接是否成功</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error) {
    </span><span><span class="hljs-keyword">die</span></span><span>(</span><span><span class="hljs-string">"连接失败: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;connect_error);
}

</span><span><span class="hljs-comment">// 执行一条故意出错的 SQL 查询</span></span><span>
</span><span><span class="hljs-variable">$query</span></span><span> = </span><span><span class="hljs-string">"SELECT * FROM non_existing_table"</span></span><span>;
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;</span><span><span class="hljs-title function_ invoke__">query</span></span><span>(</span><span><span class="hljs-variable">$query</span></span><span>);

</span><span><span class="hljs-comment">// 如果查询失败，记录错误到日志文件</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-variable">$result</span></span><span>) {
    </span><span><span class="hljs-variable">$error_message</span></span><span> = </span><span><span class="hljs-string">"MySQL 错误: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;error . </span><span><span class="hljs-string">" | 查询: "</span></span><span> . </span><span><span class="hljs-variable">$query</span></span><span>;
    </span><span><span class="hljs-title function_ invoke__">error_log</span></span><span>(</span><span><span class="hljs-variable">$error_message</span></span><span>, </span><span><span class="hljs-number">3</span></span><span>, </span><span><span class="hljs-string">"/var/log/php_error.log"</span></span><span>);
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

在这段代码中，当 SQL 查询出错时，mysqli::$error 的错误信息与 SQL 查询语句一起被记录到 /var/log/php_error.log 文件中。error_log() 的第一个参数是错误信息，第二个参数设置为 3，表示将错误写入到指定的日志文件。

3. 日志文件权限

为了确保 PHP 可以将错误写入到日志文件，日志文件必须具有适当的写权限。以 Linux 为例，确保日志文件的目录和文件本身对 PHP 进程可写：

<span><span>sudo </span><span><span class="hljs-built_in">chmod</span></span><span> 777 /var/log/php_error.log
</span></span>

或者，如果你不希望设置全局可写权限，也可以通过调整文件所属用户和用户组来赋予 PHP 进程写权限：

<span><span>sudo </span><span><span class="hljs-built_in">chown</span></span><span> www-data:www-data /var/log/php_error.log
</span></span>

4. 优化日志记录

虽然将错误记录到日志文件非常有用，但你可能希望进一步优化日志的记录方式。以下是一些优化建议：

4.1. 添加时间戳

将时间戳添加到错误日志中，可以更方便地追踪错误发生的时间。

<span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-variable">$result</span></span><span>) {
    </span><span><span class="hljs-variable">$error_message</span></span><span> = </span><span><span class="hljs-string">"["</span></span><span> . </span><span><span class="hljs-title function_ invoke__">date</span></span><span>(</span><span><span class="hljs-string">'Y-m-d H:i:s'</span></span><span>) . </span><span><span class="hljs-string">"] MySQL 错误: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;error . </span><span><span class="hljs-string">" | 查询: "</span></span><span> . </span><span><span class="hljs-variable">$query</span></span><span>;
    </span><span><span class="hljs-title function_ invoke__">error_log</span></span><span>(</span><span><span class="hljs-variable">$error_message</span></span><span>, </span><span><span class="hljs-number">3</span></span><span>, </span><span><span class="hljs-string">"/var/log/php_error.log"</span></span><span>);
}
</span></span>

4.2. 记录客户端 IP 和用户信息

如果你的应用程序是一个多用户系统，记录客户端的 IP 地址和当前用户的 ID 会非常有助于问题定位。

<span><span><span class="hljs-keyword">if</span></span><span> (!</span><span><span class="hljs-variable">$result</span></span><span>) {
    </span><span><span class="hljs-variable">$error_message</span></span><span> = </span><span><span class="hljs-string">"["</span></span><span> . </span><span><span class="hljs-title function_ invoke__">date</span></span><span>(</span><span><span class="hljs-string">'Y-m-d H:i:s'</span></span><span>) . </span><span><span class="hljs-string">"] IP: "</span></span><span> . </span><span><span class="hljs-variable">$_SERVER</span></span><span>[</span><span><span class="hljs-string">'REMOTE_ADDR'</span></span><span>] . </span><span><span class="hljs-string">" 用户ID: "</span></span><span> . </span><span><span class="hljs-variable">$_SESSION</span></span><span>[</span><span><span class="hljs-string">'user_id'</span></span><span>] . </span><span><span class="hljs-string">" MySQL 错误: "</span></span><span> . </span><span><span class="hljs-variable">$mysqli</span></span><span>-&gt;error . </span><span><span class="hljs-string">" | 查询: "</span></span><span> . </span><span><span class="hljs-variable">$query</span></span><span>;
    </span><span><span class="hljs-title function_ invoke__">error_log</span></span><span>(</span><span><span class="hljs-variable">$error_message</span></span><span>, </span><span><span class="hljs-number">3</span></span><span>, </span><span><span class="hljs-string">"/var/log/php_error.log"</span></span><span>);
}
</span></span>

4.3. 限制错误记录

如果你的日志文件已经变得非常庞大，可以考虑只记录特定类型的错误，或者使用日志轮换工具（如 logrotate）来管理日志文件。

总结

通过结合 mysqli::$error 和 error_log()，我们可以高效地将数据库错误记录到日志文件中。这不仅有助于在开发过程中快速定位问题，在生产环境中也能帮助开发者及时发现潜在的数据库错误。通过合理使用时间戳、用户信息和客户端 IP，可以进一步提高日志的可追溯性和实用性。

记得在部署到生产环境时，要确保错误日志文件的权限设置得当，以避免安全风险。

相关标签:
mysqli