PHP iconv() 轉碼截斷字符問題：//IGNORE 參數與 mb_convert_encoding() 完美替代方案

PHP iconv() 轉碼截斷字符問題：//IGNORE 參數與 mb_convert_encoding() 完美替代方案

問題現象

iconv("UTF-8", "GB2312", $data) 處理含無法映射字符的字串時，會**靜默截斷**或返回 false，導致數據丟失且難以排查。

方案一：//IGNORE 後綴（快速修復）

iconv("UTF-8", "GB2312//IGNORE", $data); // 忽略無法轉換字符，不報錯不截斷

缺點：靜默丟失字符，無感知，數據完整性無保障。

方案二：mb_convert_encoding()（推薦，功能更強、容錯更好）

<?php
/* 轉換內部編碼為 SJIS */
$str = mb_convert_encoding($str, "SJIS");

/* 將 EUC-JP 轉換成 UTF-7 */
$str = mb_convert_encoding($str, "UTF-7", "EUC-JP");

/* 從 JIS, eucjp-win, sjis-win 自動檢測並轉換至 UCS-2LE */
$str = mb_convert_encoding($str, "UCS-2LE", "JIS, eucjp-win, sjis-win");

/* "auto" 擴展為 "ASCII,JIS,UTF-8,EUC-JP,SJIS" */
$str = mb_convert_encoding($str, "EUC-JP", "auto");
?>

mb_convert_encoding() 核心優勢

最佳實踐建議

1. **專案統一 UTF-8**，從源頭消除轉碼需求
2. 必須轉碼時，**優先使用 mb_convert_encoding()**
3. 若僅需「忽略錯誤繼續」，iconv(..., "//IGNORE") 可作為輕量備選
4. 生產環境建議開啟 mbstring.substitute_character 設置替換字符（如 0x3F ?），避免靜默數據損壞