使用mysqli::get_charset 避免Unicode 表情符號存儲失敗的問題

M66 2025-05-23

在使用MySQL 數據庫存儲用戶輸入內容時，尤其是像評論、暱稱、聊天記錄這樣的文本字段，我們經常會遇到一個問題：當用戶輸入了Emoji 表情或某些特殊的Unicode 符號時，保存到數據庫會失敗，或者即使保存成功，取出來顯示時卻是亂碼或問號（ ? ）。

這是因為MySQL 數據庫默認的字符集（如utf8 ）並不能完全支持4 字節的Unicode 字符（包括大部分Emoji）。要解決這個問題，除了數據庫層面的配置外，PHP 代碼中也要確保客戶端連接的字符集是設置正確的。本文將介紹如何使用mysqli::get_charset函數檢查並確保連接字符集正確，以解決Unicode 表情無法存儲的問題。

問題背景

MySQL 的utf8編碼實際上只支持最多3 個字節的字符，而Emoji 和部分Unicode 字符需要4 個字節，因此必須使用utf8mb4 。如果服務器端（數據庫表、字段、連接）沒設置好utf8mb4 ，這些字符要么插入失敗，要么被截斷、替換成問號。

通常，我們需要做到三點：

數據庫和表的字符集設置為utf8mb4 。
數據庫連接時指定utf8mb4 。
確認PHP 代碼中使用的字符集正確。

使用mysqli::get_charset檢查字符集

PHP 的mysqli類提供了get_charset方法，可以用來獲取當前連接的字符集信息。通過這個函數，我們可以在代碼中檢查當前連接是否已經使用utf8mb4 ，並在不匹配時進行調整。

示例代碼如下：

 <?php
// 數據庫連接信息
$mysqli = new mysqli('localhost', 'username', 'password', 'database');

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

// 檢查當前連接字符集
$charsetInfo = $mysqli->get_charset();
echo '當前連接字符集: ' . $charsetInfo->charset . PHP_EOL;

// 如果不是 utf8mb4，則設置為 utf8mb4
if ($charsetInfo->charset !== 'utf8mb4') {
    if (!$mysqli->set_charset('utf8mb4')) {
        die('設置字符集失敗: ' . $mysqli->error);
    } else {
        echo '已將連接字符集設置為 utf8mb4' . PHP_EOL;
    }
}

// 示例插入含有 Emoji 的數據
$stmt = $mysqli->prepare('INSERT INTO messages (content) VALUES (?)');
$content = '測試 Emoji ?? ??';
$stmt->bind_param('s', $content);

if ($stmt->execute()) {
    echo '數據插入成功！' . PHP_EOL;
} else {
    echo '插入失敗: ' . $stmt->error . PHP_EOL;
}

$stmt->close();
$mysqli->close();
?>

數據庫配置建議

要完全支持Emoji 和其他4 字節字符，除了代碼層面的設置，還需要：

數據庫、表、字段字符集設置：

 ALTER DATABASE your_database CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
ALTER TABLE your_table CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

連接參數：確保MySQL 配置文件my.cnf中[mysqld]部分包含：

 character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

小結

使用mysqli::get_charset可以幫助我們在代碼中動態檢查連接字符集是否正確，並在必要時進行修正。結合數據庫和表的正確配置，可以徹底解決Unicode 表情符號無法存儲的問題。這樣，用戶就可以暢快地在你的應用中使用各種Emoji，而不必擔心丟失或亂碼。