简体中文
简体中文
在 PHP 开发中，数据库操作是最常见的一部分。而在与数据库交互时，尤其是使用 mysqli 扩展时，错误的捕捉和记录对于程序的调试和维护至关重要。mysqli 提供了 mysqli::$errno 和 mysqli::$error 属性，帮助开发者了解数据库操作中的具体错误原因。
本文将介绍如何使用 mysqli::$errno 来进行有效的错误日志记录，帮助开发者更好地处理数据库连接和操作时可能遇到的错误。
mysqli::$errno 是 mysqli 类的一个属性，用于存储最近一次数据库操作发生错误时的错误代码。这个错误代码是一个整数值，用于标识发生的具体错误类型。mysqli::$errno 只能在数据库操作出现错误时获得有效值，如果没有错误发生，它的值将为 0。
此外，mysqli::$error 属性则包含错误的详细描述信息（即错误消息）。这两个属性配合使用，能够帮助开发者准确诊断问题所在。
mysqli::$errno 的错误代码值是预定义的，以下是一些常见的错误代码及其含义：
1045：访问数据库时的授权错误（如用户名或密码错误）。
2002：连接失败，通常是因为数据库主机不可达。
1146：表不存在。
1064：SQL 语法错误。
在实际开发中，除了捕获错误，我们通常还需要将这些错误记录下来，以便后期查看和分析。以下是一个基本的示例，展示了如何使用 mysqli::$errno 和 mysqli::$error 进行错误日志记录：
<span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// 配置数据库连接参数</span></span><span>
</span><span><span class="hljs-variable">$host</span></span><span> = </span><span><span class="hljs-string">'localhost'</span></span><span>;
</span><span><span class="hljs-variable">$user</span></span><span> = </span><span><span class="hljs-string">'root'</span></span><span>;
</span><span><span class="hljs-variable">$password</span></span><span> = </span><span><span class="hljs-string">'password'</span></span><span>;
</span><span><span class="hljs-variable">$dbname</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-variable">$conn</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-variable">$host</span></span><span>, </span><span><span class="hljs-variable">$user</span></span><span>, </span><span><span class="hljs-variable">$password</span></span><span>, </span><span><span class="hljs-variable">$dbname</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">$conn</span></span><span>->connect_error) {
</span><span><span class="hljs-comment">// 记录连接错误</span></span><span>
</span><span><span class="hljs-title function_ invoke__">error_log</span></span><span>(</span><span><span class="hljs-string">"Connection failed: "</span></span><span> . </span><span><span class="hljs-variable">$conn</span></span><span>->connect_error, </span><span><span class="hljs-number">3</span></span><span>, </span><span><span class="hljs-string">'errors.log'</span></span><span>);
</span><span><span class="hljs-keyword">exit</span></span><span>();
}
</span><span><span class="hljs-comment">// 执行查询</span></span><span>
</span><span><span class="hljs-variable">$sql</span></span><span> = </span><span><span class="hljs-string">"SELECT * FROM non_existent_table"</span></span><span>;
</span><span><span class="hljs-variable">$result</span></span><span> = </span><span><span class="hljs-variable">$conn</span></span><span>-></span><span><span class="hljs-title function_ invoke__">query</span></span><span>(</span><span><span class="hljs-variable">$sql</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-title function_ invoke__">error_log</span></span><span>(</span><span><span class="hljs-string">"Error: "</span></span><span> . </span><span><span class="hljs-variable">$conn</span></span><span>->errno . </span><span><span class="hljs-string">" - "</span></span><span> . </span><span><span class="hljs-variable">$conn</span></span><span>->error . </span><span><span class="hljs-string">"\n"</span></span><span>, </span><span><span class="hljs-number">3</span></span><span>, </span><span><span class="hljs-string">'errors.log'</span></span><span>);
}
</span><span><span class="hljs-comment">// 关闭连接</span></span><span>
</span><span><span class="hljs-variable">$conn</span></span><span>-></span><span><span class="hljs-title function_ invoke__">close</span></span><span>();
</span><span><span class="hljs-meta">?></span></span><span>
</span></span>在这个示例中，首先尝试连接数据库。如果连接失败，则会记录连接错误到 errors.log 文件中。接着，我们执行一个查询操作，尝试从一个不存在的表中获取数据。如果查询失败，我们会捕获错误信息，并将错误代码和错误消息一同记录下来。
在生产环境中，错误日志的记录需要具备一定的时效性，因此可以将错误日志记录中加入时间戳，这样更便于问题追踪。
<span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// 获取当前时间</span></span><span>
</span><span><span class="hljs-variable">$date</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-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-title function_ invoke__">error_log</span></span><span>(</span><span><span class="hljs-string">"[<span class="hljs-subst">$date</span></span></span><span>] Error: " . </span><span><span class="hljs-variable">$conn</span></span><span>->errno . </span><span><span class="hljs-string">" - "</span></span><span> . </span><span><span class="hljs-variable">$conn</span></span><span>->error . </span><span><span class="hljs-string">"\n"</span></span><span>, </span><span><span class="hljs-number">3</span></span><span>, </span><span><span class="hljs-string">'errors.log'</span></span><span>);
}
</span><span><span class="hljs-meta">?></span></span><span>
</span></span>通过将当前时间加入到每一条错误日志中，我们能够清晰地看到每个错误发生的具体时间，帮助开发者进行更加精准的故障排查。
随着时间的推移，错误日志文件可能会变得非常庞大，影响系统性能和可维护性。因此，定期对错误日志进行清理和归档是非常重要的。可以通过以下几种方式来优化错误日志的管理：
定期归档和清理： 设置定时任务定期将错误日志文件归档，并清理旧的日志文件。
日志轮替： 使用日志轮替工具（如 logrotate）自动管理日志文件的大小。
分级日志： 根据错误的严重性，采用不同的日志级别（如信息、警告、错误）进行记录。
通过 mysqli::$errno 和 mysqli::$error，PHP 开发者可以方便地捕捉和记录数据库操作中的错误。结合时间戳、日志文件管理和清理策略，可以有效地进行错误日志的记录和优化。这些措施不仅能够帮助开发者在开发和测试阶段及时发现问题，也能在生产环境中为后期的故障排查提供重要的线索。
希望通过本文的介绍，你能更好地理解如何使用 mysqli::$errno 进行有效的错误日志记录，并将其应用到实际开发中，提升代码的健壮性和可维护性。
