在處理多語系專案或舊系統遷移時,常需將整個陣列從一種編碼(如 Big5、GBK)轉換為另一種(如 UTF-8)。傳統逐元素迴圈轉換不僅程式碼冗長,還易遺漏巢狀結構。本文介紹一種利用 var_export 與 iconv 結合的「序列化轉換法」,可一次處理任意深度的多維陣列。
function array_iconv($in_charset, $out_charset, $arr) {
// 1. var_export 產生合法 PHP 陣列定義字串(第二參數 true 為返回而非輸出)
// 2. iconv 將整串字串進行編碼轉換
// 3. eval 執行字串還原為陣列結構
return eval('return ' . iconv($in_charset, $out_charset, var_export($arr, true) . ';'));
}
array('key' => '值', ...)),保留結構與鍵名。$data = [
'title' => '測試標題',
'items' => ['項目一', '項目二', ['子項目' => '內容']],
'meta' => ['作者' => '張三', '編碼' => 'Big5']
];
// 從 Big5 轉 UTF-8
$utf8_data = array_iconv('Big5', 'UTF-8', $data);
print_r($utf8_data);
| 優點 | 缺點/注意事項 |
|---|---|
| 程式碼極度精簡(單一函式) | 使用 eval() 有潛在安全風險,輸入必須可信 |
| 自動處理多維、關聯、數值索引陣列 | 極大陣列可能超出記憶體或執行時間限制 |
| 保留原始鍵名與結構,無需遞迴遍歷 | 資源型別、物件實例無法正確序列化 |
| 適用於純量值(字串、數字、布林、null) | 若字串包含單引號需注意跳脫(var_export 會自動處理) |
若專案禁止 eval 或處理超大陣列,建議使用遞迴函式:
function array_iconv_recursive($in_charset, $out_charset, $array) {
foreach ($array as $key => $value) {
$new_key = iconv($in_charset, $out_charset, $key);
if (is_array($value)) {
$array[$new_key] = array_iconv_recursive($in_charset, $out_charset, $value);
} elseif (is_string($value)) {
$array[$new_key] = iconv($in_charset, $out_charset, $value);
} else {
$array[$new_key] = $value;
}
if ($new_key !== $key) unset($array[$key]);
}
return $array;
}
var_export + iconv + eval 方案適合中小型、可信資料的快速轉碼;大型專案或安全敏感環境請改用遞迴遍歷或 mb_convert_encoding 陣列版本。選擇時請評估資料來源可信度與效能需求。