PHP iconv 編碼轉換截斷問題解決：//IGNORE 參數與 mb_convert_encoding 替代方案

解決 PHP iconv() 在中文編碼轉換（如 UTF-8 → GB2312）時遇到無法轉換字元導致輸出截斷的問題：使用 //IGNORE 忽略錯誤字元，或改用 mb_convert_encoding() 獲得更穩健的多編碼支援。

問題現象

<?php
$data = "包含特殊字元的字串…";
$result = iconv("UTF-8", "GB2312", $data);
// 若 $data 含 GB2312 無法表示的字元，iconv 會在該位置停止，回傳不完整字串
?>

方案一：iconv //IGNORE 參數（快速修正）

<?php
$result = iconv("UTF-8", "GB2312//IGNORE", $data);
// 無法轉換的字元會被靜默丟棄，不中斷流程
?>

• 語法：目標編碼//IGNORE（雙斜線）。
• 行為：遇到無法轉換字元直接跳過，不報錯、不截斷。
• 缺點：資料靜默遺失，可能造成資訊損失，需評估可接受度。

方案二：mb_convert_encoding()（推薦通用）

<?php
// 基本用法：指定來源與目標編碼
$str = mb_convert_encoding($str, "SJIS");           // 內部編碼 → SJIS
$str = mb_convert_encoding($str, "UTF-7", "EUC-JP"); // EUC-JP → UTF-7

// 多來源編碼自動偵測
$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");
?>

iconv vs mb_convert_encoding 比較

最佳實務建議

1. 新專案優先使用 mb_convert_encoding()，編碼支援更完整、行為一致。
2. 既有 iconv 代碼快速修正：加上 //IGNORE 避免截斷崩潰。
3. 關鍵資料轉換前後必須驗證長度/內容完整性，不可盲目信任轉換結果。
4. 統一專案內部編碼為 UTF-8，儲存、傳輸、資料庫、HTML 全鏈路一致，減少轉換需求。
5. 需轉換至 Legacy 編碼（Big5, GB2312）時，建議建立字元對照表測試覆蓋率。

常見編碼名稱對照

// 繁體中文
Big5, Big5-HKSCS, CP950
// 簡體中文
GB2312, GBK, GB18030, CP936
// 日文
SJIS, EUC-JP, CP932, JIS
// Unicode
UTF-8, UTF-16, UTF-32, UCS-2, UCS-4

選對編碼轉換工具並妥善處理例外字元，是多語言系統穩定運行的關鍵基礎設施。