萬盛學電腦網

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

PHP iconv 函數完整指南:編碼轉換、參數詳解、常見坑點與 mb_convert_encoding 對比

基本語法

string iconv(string $from_encoding, string $to_encoding, string $string): string|false

目標編碼後綴(關鍵)

後綴行為
//TRANSLIT無法直接轉換的字元 → 近似字元(如「—」→ "--")
//IGNORE直接丟棄無法轉換的字元,繼續處理後續內容
(無)遇到非法字元截斷,後續內容遺失

範例:iconv('UTF-8', 'GB2312//IGNORE', $data)

實戰範例

<?php
header('Content-Type: application/vnd.ms-excel; charset=UTF-8');
$name = iconv('UTF-8', 'GB2312//IGNORE', $data['year'].'年,第'.$data['period'].'期通訊錄');
header('Content-Disposition: attachment; filename="'.$name.'.xls"');
// 解決 Excel 匯出中文檔名亂碼
?>

完整函數族群演示

<?php
$str = '你好,這裡賣咖啡!';
echo $str . '<br>';
echo iconv('GB2312', 'UTF-8', $str) . '<br>';          // 轉碼
echo iconv_substr($str, 1, 1, 'UTF-8') . '<br>';       // 按字元截取(非位元組)
print_r(iconv_get_encoding());                          // 取得目前編碼設定
echo iconv_strlen($str, 'UTF-8') . '<br>';             // 字元長度
// 另一種寫法
$content = iconv('UTF-8', 'GBK//TRANSLIT', $content);
?>

安裝與啟用

  • Windows:php.ini 取消註解 extension=php_iconv.dll,將 iconv.dll 放入 System32
  • Linux:編譯 PHP 時加 --with-iconv=/usr/local/libiconv,或安裝 libiconv 套件
  • PHP 5+ 內建,通常無需額外編譯

iconv vs mb_convert_encoding

維度iconvmb_convert_encoding
效能高(C 底層)較低
自動偵測來源編碼不支援支援(auto 或陣列列表)
非法字元處理//IGNORE///TRANSLIT預設忽略,可配置
特殊字元 Bug「—」轉 GB2312 會截斷無此問題
建議策略首選,編碼確定時編碼不確定或 iconv 失效時備用

mb_convert_encoding 範例

<?php
header('Content-Type: text/html; charset=UTF-8');
echo mb_convert_encoding('妳係我的友仔', 'UTF-8', 'GBK');      // GBK→UTF-8
echo mb_convert_encoding('你是我的朋友', 'BIG5', 'GB2312');   // GB2312→BIG5
?>

需啟用 extension=mbstring。

常見錯誤與避坑

  1. 忘記 //IGNORE 導致字串莫名截斷
  2. 來源編碼判斷錯誤(如誤以 UTF-8 讀取 GBK 檔)
  3. Windows 下 iconv.dll 版本衝突,建議用 PHP 內建版本
copyright © 萬盛學電腦網 all rights reserved