在PHP中如何通過mb_get_info 檢查數據庫編碼與字符集是否一致

gitbox 2025-05-11

在開發多語言網站或應用時，字符編碼問題常常成為開發者頭疼的難題。尤其是當數據庫和PHP 程序之間的字符集不一致時，極易導致中文亂碼、特殊字符顯示錯誤等問題。雖然PHP 提供了多種手段來控製字符集設置，但你可能會忽視mbstring擴展中一個非常實用的函數—— mb_get_info() 。

本文將介紹如何使用mb_get_info()函數來檢查PHP 當前使用的多字節字符編碼，並與數據庫的設置進行比對，以判斷兩者是否一致。

什麼是mb_get_info() ？

mb_get_info()是PHP 多字節字符串擴展（mbstring）中的一個函數，用於返回當前mbstring 的相關設置信息。

函數原型：

 mb_get_info(string $type = null): string|array

不傳參數時，返回一個包含所有相關設置信息的數組。
傳入參數如"internal_encoding"可以獲取當前的內部編碼。

實戰：檢查PHP 與數據庫的編碼是否一致

假設你在連接數據庫時設置了編碼為utf8mb4 ，我們可以通過以下步驟來確認PHP 的多字節字符串設置是否一致。

第一步：連接數據庫並設置字符集

$mysqli = new mysqli('localhost', 'user', 'password', 'my_database');
$mysqli->set_charset('utf8mb4');

確保數據庫連接的字符集已經設置為你想要的目標編碼，比如utf8mb4 。

第二步：檢查mbstring 的當前設置

$mbInfo = mb_get_info();

echo "當前 mbstring 內部編碼: " . $mbInfo['internal_encoding'] . PHP_EOL;

或者更簡潔的寫法：

 echo "當前 mbstring 編碼: " . mb_get_info("internal_encoding") . PHP_EOL;

默認情況下，mbstring 的內部編碼可能是UTF-8 ，但你應該顯式設置它以防止不一致：

 mb_internal_encoding("UTF-8");

第三步：對比並給出提示

完整的檢測代碼如下：

 <?php
$mysqli = new mysqli('localhost', 'user', 'password', 'my_database');
$mysqli->set_charset('utf8mb4');

mb_internal_encoding("UTF-8");

$dbCharset = $mysqli->character_set_name(); // 獲取數據庫連接的字符集
$phpCharset = mb_get_info("internal_encoding"); // 獲取 PHP 的字符集

if (strcasecmp($dbCharset, $phpCharset) === 0 || stripos($dbCharset, $phpCharset) !== false) {
    echo "? 數據庫字符集和 PHP 的 mbstring 編碼一致：$dbCharset" . PHP_EOL;
} else {
    echo "? 不一致！數據庫使用的是 $dbCharset，PHP mbstring 使用的是 $phpCharset" . PHP_EOL;
}
?>

補充建議

始終設置默認編碼：在項目初始化時統一設置mb_internal_encoding() ，如放在入口文件中。
檢測mbstring 擴展是否啟用：

 if (!extension_loaded('mbstring')) {
    die("mbstring 擴展未啟用，請在 php.ini 中開啟！");
}

保持前端一致性：前端HTML 頁面也應聲明一致的字符集，如：

 <meta charset="UTF-8">

總結

雖然mb_get_info()本身並不能直接訪問數據庫字符集設置，但它提供了觀察PHP 多字節字符串環境的窗口。通過將其結果與數據庫連接的字符集進行比對，你可以更容易排查編碼不一致的問題。別再讓字符集問題困擾你的開發流程，提前檢查，事半功倍！

如需了解更多編碼處理技巧，請訪問： https://gitbox.net/php/encoding-guide