PHP 與 UTF-8的最佳實踐

本文是「PHP、字串、編碼、UTF-8」相關知識的第二部分。先說結論－在 PHP 中的各個方面使用 UTF-8編碼。

　　PHP 語言層面是不支援 Unicode字元集的，但可以透過 UTF-8 編碼能處理大部分問題。

　　最佳實踐就是明確知道輸入編碼（不知道就偵測），內部統一轉換為 UTF-8 編碼，輸出編碼也統一是 UTF-8編碼。

　　PHP 層面如何處理 UTF-8

　　當操作 Unicode 字元集的時候，請務必安裝 mbstring 擴展，並使用對應的函數來取代原生的字串函數。舉個例子，一個檔案編碼為 UTF-8 的 PHP 程式碼，假如使用 strlen() 函數是錯誤的，請使用 mb_strlen() 函數取代。

　　mbstring 擴充大部分的函數都需要基於一個編碼（內部編碼）來處理，請務必統一使用 UTF-8 編碼，這個大部分可以在 PHP.INI 中配置。

　　從 PHP 5.6 開始，default_charset 配置可以取代 mbstring.http_input，mbstring.http_output 。

　　另一個重要的配置就是 mbstring.language，這個預設值是 Neutral（UTF-8）。

　　注意檔案編碼和 mbstring 擴充的內部編碼不是同一個概念。

　　概括的說來：

• PHP.INI 中涉及到 mbstring 擴充的部分盡量使用 UTF-8。

• 請用 mbstring 擴充函數取代原生字串運算函數。

• 在使用相關函數的時候，請務必了解你操作的字元的編碼是什麼，在使用對應函數的時候，顯示的寫上UTF-8 編碼參數，例如htmlentities() 函數的第三個參數顯示寫上UTF-8。

　　文件 IO 操作 如何處理 UTF-8

　　這裡舉個例子，假如你要打開一個文件，但是不知道文件內容是什麼編碼的，那麼如何處理呢？

　　最佳實踐就是，在打開的時候統一轉換成 UTF-8，修改內容後就再轉回原來的編碼並保存到文件。看程式把：

if ( mb_internal_encoding()!="UTF-8") {
        mb_internal_encoding("UTF-8");
}
 
$file = "file.txt"; //一个编码为gbk的中文文件
$str= file_get_contents($file);
//不管来源是什么编码，统一显示的时候转换为 UTF-8
 if (mb_check_encoding($str,"GBK"))
    $str =  mb_convert_encoding($str,"UTF-8",“GBK”);
 
$str ="修改内容";
$str =  mb_convert_encoding($str,$srcbm,"UTF-8"); //原样转回去
file_put_contents($file,$str);

　　Mysql 和 UTF-8 的最佳實踐

　　這個相對簡單，首先保證你的 Mysql 都是 UTF-8。然後 Mysql 用戶端連線的時候也保持 UTF-8，具體到 PHP 中，就是 imysql 或者 PDO 擴充連接 Mysql 的時候都設定 UTF-8 作為連線編碼，二邊保持一致，一般就不會遇到問題。

　　瀏覽器和UTF-8 的最佳實踐

　　這個也比較簡單，就是你的輸出內容假如是網頁，那麼你的字符串處理輸出最總請保持為UTF-8 ；同時PHP.INI 中也明確設定default_charset 為UTF-8；HTML 的Meta Tag 也明確標示為UTF-8。

　　現在萬事大吉了嗎，並沒有，雖然伺服器和瀏覽器讓用戶使用UTF-8 編碼，但是用戶的行為並沒有約束性，他可能輸入的是其他編碼的字符，或者上傳的文件名是其他編碼的字符，那麼怎麼辦呢？可以透過 mb_http_input() 和 mb_check_encoding() 函數來偵測使用者的編碼，然後內部轉換為 UTF-8。確保在任何一個層面，最終處理的是 UTF-8 編碼。換句話說，需要手段能夠知曉你的輸入是什麼編碼的，處理完成後控制輸出的編碼是 UTF-8。

　　不建議使用 mbstring.encoding_translation 指令 和 mb_detect_encoding() 函式。折磨我半天。

　　作業系統和 UTF-8 的最佳實務

　　由於作業系統的原因，PHP 處理 Unicode 檔案名稱的時候會有不同的處理機制。

　　在 Linux 中，檔案名稱始終是 UTF-8 編碼的，而在中文 Windows 環境下，檔案名稱始終是 GBK 編碼的，記住這一點就可以了。

　　透過範例說明下:

//命令行程序函数，运行在中文版 Windows 10 操作系统 ，文件编码为 UTF-8
 function filenameexample() {
    $filename = "测试.txt" ;
    $gbk_filename = iconv("UTF-8","GBK",$filename);
    file_put_contents($gbk_filename, "测试");
    echo file_get_contents($gbk_filename);
}
 function scandirexample() {
    $arr = scandir("./tmp");
    foreach ($arr as $v) {
        if ($v == "." || $v =="..")
            continue ;
        $filename = iconv( "GBK","UTF-8",$v ) ;
        $content = file_get_contents("./tmp/" . $v );
    }
}

　　假如不想寫寫兼容Windows 和linux 的程序，可以對檔名進行urlencode 編碼，例如：

function urlencodeexample() {
   $filename = "测试2.txt" ;
   $urlencodefilename = urlencode($filename) ;
   file_put_contents($urlencodefilename, "测试");
   echo file_get_contents($urlencodefilename);
}

　 透過下載函數在用PHPheader()

　 透過下載函數瀏覽器和作業系統（大部分人使用的是Windows），對Chrome 來說，輸出的檔案名稱編碼可以是UTF-8，Chrome 會自動將檔案名稱轉換為GBK 編碼。

　　而對於低版本的 IE 來說，它繼承了作業系統的環境，所以下載檔案名稱假如是中文必須轉碼為 UTF-8 編碼，否則下載的時候用戶看到的是亂碼檔案名稱。透過程式碼來說明：

$agent=$_SERVER["HTTP_USER_AGENT"];
if(strpos($agent,'MSIE')!==false  ｛
    $filename = iconv("UTF-8","GBK","附件.txt");
    header("Content-Disposition: attachment; filename=\"$filename\"");
｝

🎜