mysqli::set_charset 和數據庫默認字符集的關係

gitbox 2025-05-26

在使用PHP 的mysqli擴展連接數據庫時，常常會看到開發者使用mysqli::set_charset方法來設置字符集。那麼， mysqli::set_charset設置的字符集和數據庫本身的默認字符集有什麼關係呢？它們之間會不會衝突？本文將詳細講解這兩者的關係以及最佳實踐。

數據庫默認字符集是什麼？

數據庫默認字符集指的是數據庫服務器或者某個數據庫實例（schema）配置的默認字符集。比如，MySQL 數據庫在創建時會有一個默認字符集，常見的是utf8mb4或者latin1 。如果你創建表或字段時沒有指定字符集，就會繼承數據庫的默認字符集。

可以通過SQL 語句查看當前數據庫默認字符集：

 SHOW VARIABLES LIKE 'character_set_database';

也可以查看服務器默認字符集：

 SHOW VARIABLES LIKE 'character_set_server';

mysqli::set_charset 是什麼？

mysqli::set_charset是PHP mysqli類的一個方法，用來設置當前連接的字符集。該設置告訴數據庫服務器客戶端發來的數據用什麼字符編碼進行解析，以及查詢結果返回時使用什麼編碼。

 $mysqli = new mysqli('gitbox.net', 'user', 'password', 'database');
$mysqli->set_charset('utf8mb4');

在上面的代碼中， set_charset('utf8mb4')表示告訴MySQL 服務器，客戶端發送和接收的數據都採用utf8mb4編碼。

兩者的關係和區別

作用範圍不同

數據庫默認字符集影響的是數據庫層面，主要控制數據表默認使用什麼編碼存儲數據。
mysqli::set_charset影響的是客戶端與數據庫之間通信的編碼格式。

影響的數據階段不同

數據庫默認字符集決定數據在數據庫裡的存儲格式。
mysqli::set_charset決定客戶端與服務器之間交換數據的編碼格式，確保雙方一致。

優先級和匹配

當你連接數據庫時，如果沒有顯式設置mysqli::set_charset ，客戶端和服務器之間通信使用的是服務器默認字符集（一般為latin1 ，除非配置改了）。這會導致當你的數據庫默認字符集是utf8mb4 ，而客戶端通信編碼是latin1時，數據可能出現亂碼。

所以，即使數據庫表是utf8mb4 ，如果連接時沒有用set_charset告訴服務器用相同編碼傳輸數據，查詢結果或插入數據都可能出現編碼錯亂。

為什麼建議總是調用mysqli::set_charset？

為了避免因客戶端和服務器字符集不一致而導致亂碼，最佳實踐是連接數據庫後，立即調用：

 $mysqli->set_charset('utf8mb4');

這保證了：

傳輸的數據編碼與數據庫編碼一致
查詢結果的編碼正確
避免因編碼不匹配造成的異常字符問題

結論

數據庫默認字符集決定了數據的存儲編碼。
mysqli::set_charset決定客戶端與服務器通信的編碼格式。
兩者必須保持一致，才能確保數據正確傳輸和存儲。
即使數據庫默認字符集是utf8mb4 ，也要在PHP 代碼中用set_charset明確設置連接編碼。

參考代碼示例

$mysqli = new mysqli('gitbox.net', 'username', 'password', 'database');

if ($mysqli->connect_error) {
    die('連接失敗：' . $mysqli->connect_error);
}

// 設置客戶端連接字符集為 utf8mb4
$mysqli->set_charset('utf8mb4');

$sql = "SELECT * FROM users";
$result = $mysqli->query($sql);

while ($row = $result->fetch_assoc()) {
    echo $row['username'] . "<br>";
}

$mysqli->close();

這樣可以確保從數據庫中取出的中文或者特殊字符不會出現亂碼。