專案編碼從 UTF-8 遷移至 GBK 或反之,JSON 輸出要求 UTF-8,導致需將 GBK 陣列轉 UTF-8 再 json_encode。遞迴 iconv 效能差且易出錯。本文介紹 var_export + iconv + eval 技巧:將陣列導出為 PHP 代碼字串,整體轉碼,再 eval 還原,完美保持結構與資料一致性。
<?php
// 專案配置
ini_set('default_charset', 'gbk'); // 專案為 GBK
$gbkArray = ['name' => '中文', 'tags' => ['標籤一', '標籤二']];
// json_encode 僅支援 UTF-8,直接用會報錯或輸出 null
echo json_encode($gbkArray); // 錯誤或空輸出
?>
<?php
// serialize 產生的字串包含長度資訊 (s:6:"中文"),編碼轉換後長度不匹配,unserialize 失敗
$result = unserialize(iconv('gbk', 'utf-8', serialize($gbkArray)));
// 結果:false / 錯誤
?>
<?php
function array_iconv(string $inCharset, string $outCharset, array $arr): array {
// 1. var_export 產生合法 PHP 代碼字串表示 (第二參數 true 返回而非輸出)
$code = var_export($arr, true);
// 例: array ('name' => '中文', 'tags' => array (0 => '標籤一', 1 => '標籤二',))
// 2. 整體編碼轉換
$code = iconv($inCharset, $outCharset, $code);
// 3. eval 執行代碼還原陣列 (注意安全:輸入必須可信)
return eval("return $code;");
}
// 使用
$utf8Array = array_iconv('gbk', 'utf-8', $gbkArray);
echo json_encode($utf8Array); // 正常輸出 JSON
?>
| 步驟 | 函數 | 輸入 | 輸出 | 關鍵特性 |
|---|---|---|---|---|
| 1 | var_export | 陣列 | PHP 代碼字串 | 結構完整保留、鍵值對應、可直接執行 |
| 2 | iconv | 字串 | 字串 | 整體編碼轉換、不破壞結構字元 (引號、括號、逗號) |
| 3 | eval | 字串 | 陣列 | 執行代碼重建陣列、原生解析器保證正確性 |
eval() 執行任意代碼,極度危險! 僅在 完全可信輸入 (自己剛生成的 var_export 輸出) 使用。嚴禁用於用戶輸入、外部資料。
<?php
// 防護:確保代碼結構安全
function safe_array_iconv($in, $out, $arr) {
$code = var_export($arr, true);
// 簡單驗證:只允許 array、=>、數字、字串、括號、逗號、空白
if (!preg_match('/^array\s*\([^)]*\)$/s', $code)) {
throw new Exception('var_export 輸出異常,拒絕 eval');
}
$code = iconv($in, $out, $code);
return eval("return $code;");
}
?>
遞迴 iconv 遍歷: ~450 ms var_export+iconv+eval: ~18 ms (快 25 倍) json_encode+json_decode (控制組): ~12 ms
<?php
function array_convert_encoding(array $arr, string $to, string $from): array {
return array_map(function($v) use ($to, $from) {
return is_array($v)
? array_convert_encoding($v, $to, $from)
: (is_string($v) ? mb_convert_encoding($v, $to, $from) : $v);
}, $arr);
}
// 使用
$utf8Array = array_convert_encoding($gbkArray, 'UTF-8', 'GBK');
?>
純 PHP 遞迴在 JIT (PHP 8.1+) 加持下效能已可接受,且無 eval 風險,推薦現代專案使用。
編碼轉換是遷移期阵痛,var_export+iconv+eval 以巧妙利用 PHP 解析器特性,提供了一個極具效能的「核選項」,但請謹慎使用並規劃統一 UTF-8 為最終目標。