PHP 中的 mysqli_connect_error() 连接错误处理指南：提供用户友好的错误信息

2024-03-26 17:25:43

## 在 PHP 中优雅地处理 mysqli_connect_error() 连接错误

在与数据库建立连接时，处理连接错误至关重要。mysqli_connect_error() 函数可用于检索连接错误的详细信息。然而，如果处理不当，它可能会向用户显示不必要的技术细节。本文将探讨如何使用 mysqli_connect_error() 来优雅地处理连接错误，避免向用户显示敏感信息。

问题：向用户显示敏感的连接错误

在给定的代码示例中，mysqli_connect_error() 函数返回一个包含连接错误的字符串。该字符串对于调试很有用，但向用户显示它可能会造成安全风险并损害用户体验。

解决方案：创建一个用户友好的错误消息

为了避免向用户显示错误详细信息，可以采取以下步骤：

1. 检查错误代码

mysqli_connect_error() 函数返回一个错误代码，表示连接失败的原因。可以使用该代码来确定错误的类型。

2. 创建自定义错误消息

根据错误代码，创建一个用户友好的错误消息，向用户传达连接失败的原因，而不会透露技术细节。

3. 显示自定义错误消息

使用适当的方法向用户显示自定义错误消息，例如使用 echo 语句或将错误消息存储在会话变量中以供稍后显示。

4. 使用 HTTP 状态代码

根据错误的严重程度，可以使用适当的 HTTP 状态代码来指示连接错误。对于无法处理的错误，例如无效的用户名/密码，可以使用 HTTP 401 未授权状态代码。对于其他类型的错误，可以使用 HTTP 503 服务不可用状态代码。

示例代码

function connectDatabase(){
        $dbServerName = 'local_host';
        $dbUsername = 'root';
        $dbPassword = '';
        $dbName = 'kishor_me';

        $conn = mysqli_connect($dbServerName, $dbUsername, $dbPassword, $dbName);
        
        if (!$conn) {
            if (mysqli_connect_errno() == 1045) {
                $errorMessage = "抱歉，你的用户名或密码不正确。";
            } elseif (mysqli_connect_errno() == 2002) {
                $errorMessage = "无法连接到数据库。请检查你的互联网连接或联系系统管理员。";
            } else {
                $errorMessage = "未知错误。请稍后再试。";
            }
            
            header("HTTP/1.1 401 Unauthorized");
            echo $errorMessage;
            exit;
        }else{
            // 连接成功
        }
    }