在 PHP 與 MySQL 協同開發網站時,瀏覽器輸出中文亂碼幾乎是每位開發者必經的「成人禮」。問題的核心在於三者編碼不一致:HTML 網頁編碼、PHP 檔案編碼、MySQL 資料庫編碼。本文將系統梳理亂碼成因,並提供經實戰驗證的解決方案。
亂碼的本質是字元編碼解碼錯誤。當 PHP 以 UTF-8 讀取資料庫中的 GBK 資料,或網頁宣告 UTF-8 卻輸出 Big5 內容時,瀏覽器便會顯示不可識別的「天書」。常見場景包括:
PHP 提供 iconv() 函數進行字元集轉換,語法如下:
string iconv ( string $in_charset , string $out_charset , string $str )
實際範例:
<?php
$text = "This is the Euro symbol '€'. ";
echo 'Original : ', $text, PHP_EOL;
echo 'TRANSLIT : ', iconv("UTF-8", "ISO-8859-1//TRANSLIT", $text), PHP_EOL;
echo 'IGNORE : ', iconv("UTF-8", "ISO-8859-1//IGNORE", $text), PHP_EOL;
echo 'Plain : ', iconv("UTF-8", "ISO-8859-1", $text), PHP_EOL;
?>
實戰提醒:許多開發者反映 iconv 在特定環境下「無報錯、不轉碼、無輸出」,穩定性不足。
經測試,mb_convert_encoding() 在 GBK/UTF-8 互轉上表現更穩健。核心步驟:
// 檢查擴展是否可用
echo function_exists('mb_convert_encoding');
// 偵測當前編碼
echo mb_detect_encoding($val, "GBK, GB2312, UTF-8");
// 執行轉換:CP936(GBK) → UTF-8
$v = mb_convert_encoding($val, "UTF-8", "CP936");
為了批次處理資料庫查詢結果集(含陣列、巢狀結構),封裝遞迴轉換函數 auto_charset():
function auto_charset($fContents, $from='gbk', $to='utf-8') {
$from = strtoupper($from)=='UTF8' ? 'utf-8' : $from;
$to = strtoupper($to)=='UTF8' ? 'utf-8' : $to;
if (strtoupper($from) === strtoupper($to) || empty($fContents) || (is_scalar($fContents) && !is_string($fContents))) {
return $fContents; // 編碼相同或非字串標量直接返回
}
if (is_string($fContents)) {
return function_exists('mb_convert_encoding')
? mb_convert_encoding($fContents, $to, $from)
: $fContents;
} elseif (is_array($fContents)) {
foreach ($fContents as $key => $val) {
$_key = auto_charset($key, $from, $to);
$fContents[$_key] = auto_charset($val, $from, $to);
if ($key != $_key) unset($fContents[$key]);
}
return $fContents;
}
return $fContents;
}
$arr = array();
while ($list = mssql_fetch_row($row)) {
$arr[] = $list;
}
$s = auto_charset($arr, 'gbk', 'utf-8');
// 瀏覽器設定 UTF-8 編碼後輸出
print_r($s); die();
SET NAMES utf8。php.ini 設定 default_charset = "UTF-8" 或程式碼中 header("Content-Type: text/html; charset=utf-8")。auto_charset() 統一轉換外部資料編碼。掌握編碼流向、善用 mbstring 擴展,中文亂碼不再是難題。