通過mysqli::character_set_name 確保字符集與MySQL 配置一致

什麼是mysqli::character_set_name ？

mysqli::character_set_name是PHP 的mysqli 擴展中的一個方法，它返回當前數據庫連接所使用的字符集名稱。該方法的原型如下：

 string mysqli::character_set_name ( void )

這意味著你可以在執行SQL 操作之前調用它，以確認連接使用的字符集是否與你的數據庫配置一致。

為什麼字符集一致性很重要？

MySQL 支持多種字符集，例如utf8 、 utf8mb4 、 latin1等。字符集不一致會導致以下問題：

• 中文字符亂碼或被截斷

• 無法正確執行包含多語言內容的查詢

• 數據寫入數據庫後再次讀取出現異常

特別是當MySQL 的默認字符集與PHP 使用的字符集不一致時，問題尤為常見。因此，在連接建立之後及時驗證字符集是一種良好的實踐。

如何使用mysqli::character_set_name ？

下面是一個完整的示例，用於檢測並確認當前連接的字符集設置：

 <?php
$mysqli = new mysqli("localhost", "user", "password", "database");

// 檢查連接是否成功
if ($mysqli->connect_errno) {
    die("連接失敗: " . $mysqli->connect_error);
}

// 獲取當前連接的字符集
$currentCharset = $mysqli->character_set_name();

echo "當前連接使用的字符集是: " . $currentCharset;

// 檢查是否為期望的字符集，比如 utf8mb4
if ($currentCharset !== 'utf8mb4') {
    echo "字符集不一致，正在設置為 utf8mb4...";
    if (!$mysqli->set_charset("utf8mb4")) {
        die("設置字符集失敗: " . $mysqli->error);
    }
    echo "字符集已更新為: " . $mysqli->character_set_name();
}
?>

該示例連接到數據庫後，首先輸出當前使用的字符集。如果不是utf8mb4 ，則嘗試重新設置字符集。通過mysqli::set_charset與mysqli::character_set_name的配合，確保字符集完全一致。

配置一致性的延伸：從MySQL 配置文件讀取默認字符集

如果你想確保PHP 使用的字符集與服務器端的默認字符集完全一致，可以考慮從MySQL 的配置文件（通常是my.cnf或my.ini ）中讀取默認設置。

例如，可以用如下SQL 查詢查看服務器端默認的字符集設置：

 <?php
$result = $mysqli->query("SHOW VARIABLES LIKE 'character_set_server'");
$row = $result->fetch_assoc();
$serverCharset = $row['Value'];

echo "MySQL服務器默認字符集是: " . $serverCharset;

if ($mysqli->character_set_name() !== $serverCharset) {
    echo "檢測到字符集不一致，正在嘗試同步...";
    if (!$mysqli->set_charset($serverCharset)) {
        die("設置字符集失敗: " . $mysqli->error);
    }
    echo "字符集已同步為: " . $mysqli->character_set_name();
}
?>

這段代碼不僅檢查當前連接的字符集，還與服務器的默認字符集做對比，自動同步字符集設置，進一步保障數據一致性。