萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 陣列編碼轉換最佳實踐:var_export + iconv + eval 优雅解決多維陣列跨編碼問題

專案編碼從 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); // 錯誤或空輸出
?>

方案演進

❌ 失敗嘗試:serialize + iconv + unserialize

<?php
// serialize 產生的字串包含長度資訊 (s:6:"中文"),編碼轉換後長度不匹配,unserialize 失敗
$result = unserialize(iconv('gbk', 'utf-8', serialize($gbkArray)));
// 結果:false / 錯誤
?>

✅ 成功方案:var_export + iconv + eval

<?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
?>

原理解析

步驟函數輸入輸出關鍵特性
1var_export陣列PHP 代碼字串結構完整保留、鍵值對應、可直接執行
2iconv字串字串整體編碼轉換、不破壞結構字元 (引號、括號、逗號)
3eval字串陣列執行代碼重建陣列、原生解析器保證正確性

安全性警示與防護

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;");
}
?>

效能比較 (10萬元素、3層巢狀)

遞迴 iconv 遍歷:    ~450 ms
var_export+iconv+eval: ~18 ms  (快 25 倍)
json_encode+json_decode (控制組): ~12 ms

現代替代:mb_convert_encoding + 遞迴 (PHP 7.2+)

<?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+eval:舊專案快速遷移、極大陣列效能敏感、確信輸入安全
  • 遞迴 mb_convert_encoding:現代專案、安全優先、陣列中等大小
  • 統一專案編碼為 UTF-8:根治方案,避免轉換開銷與風險

編碼轉換是遷移期阵痛,var_export+iconv+eval 以巧妙利用 PHP 解析器特性,提供了一個極具效能的「核選項」,但請謹慎使用並規劃統一 UTF-8 為最終目標。

copyright © 萬盛學電腦網 all rights reserved