PHP 全形半形字符轉換函數實現

背景

在處理用戶輸入、數據清洗或跨系統交互時，常遇到全形（全角）與半形（半角）字符混雜的問題。直接使用 ASCII 碼轉換往往因編碼差異導致異常。最穩妥的方式是建立完整的字符映射表，逐一替換。

完整轉換函數

<?php
/**
 * 全形字符轉換為半形
 * @param string $str 輸入字符串
 * @return string 轉換後字符串
 */
public function Sbc2Dbc($str) {
    $arr = array(
        // 數字
        '０'=>'0', '１'=>'1', '２'=>'2', '３'=>'3', '４'=>'4',
        '５'=>'5', '６'=>'6', '７'=>'7', '８'=>'8', '９'=>'9',
        // 大寫字母
        'Ａ'=>'A', 'Ｂ'=>'B', 'Ｃ'=>'C', 'Ｄ'=>'D', 'Ｅ'=>'E',
        'Ｆ'=>'F', 'Ｇ'=>'G', 'Ｈ'=>'H', 'Ｉ'=>'I', 'Ｊ'=>'J',
        'Ｋ'=>'K', 'Ｌ'=>'L', 'Ｍ'=>'M', 'Ｎ'=>'N', 'Ｏ'=>'O',
        'Ｐ'=>'P', 'Ｑ'=>'Q', 'Ｒ'=>'R', 'Ｓ'=>'S', 'Ｔ'=>'T',
        'Ｕ'=>'U', 'Ｖ'=>'V', 'Ｗ'=>'W', 'Ｘ'=>'X', 'Ｙ'=>'Y', 'Ｚ'=>'Z',
        // 小寫字母
        'ａ'=>'a', 'ｂ'=>'b', 'ｃ'=>'c', 'ｄ'=>'d', 'ｅ'=>'e',
        'ｆ'=>'f', 'ｇ'=>'g', 'ｈ'=>'h', 'ｉ'=>'i', 'ｊ'=>'j',
        'ｋ'=>'k', 'ｌ'=>'l', 'ｍ'=>'m', 'ｎ'=>'n', 'ｏ'=>'o',
        'ｐ'=>'p', 'ｑ'=>'q', 'ｒ'=>'r', 'ｓ'=>'s', 'ｔ'=>'t',
        'ｕ'=>'u', 'ｖ'=>'v', 'ｗ'=>'w', 'ｘ'=>'x', 'ｙ'=>'y', 'ｚ'=>'z',
        // 標點符號
        '（'=>'(', '）'=>')', '〔'=>'(', '〕'=>')', '【'=>'[', '】'=>']',
        '〖'=>'[', '〗'=>']', '“'=>'"', '”'=>'"',
        '‘'=>''', '''=>''', '｛'=>'{', '｝'=>'}',
        '《'=>'<', '》'=>'>', '％'=>'%', '＋'=>'+',
        '—'=>'-', '－'=>'-', '～'=>'~', '：'=>':',
        '。'=>'.', '、'=>',', '，'=>',', '、'=>',',
        '；'=>';', '？'=>'?', '！'=>'!', '…'=>'-',
        '‖'=>'|', '”'=>'"', '''=>'`', '‘'=>'`',
        '｜'=>'|', '〃'=>'"', ' '=>' ', '×'=>'*',
        '￣'=>'~', '．'=>'.', '＊'=>'*', '＆'=>'&',
        '＜'=>'<', '＞'=>'>', '＄'=>'$', '＠'=>'@',
        '＾'=>'^', '＿'=>'_', '＂'=>'"', '￥'=>'$',
        '＝'=>'=', '＼'=>'\\', '／'=>'/'
    );
    return strtr($str, $arr);
}

使用示例

<?php
$input = "Ｈｅｌｌｏ　Ｗｏｒｌｄ！１２３";
$output = Sbc2Dbc($input);
echo $output; // Hello World!123

原理解析

• strtr()：按字符級別替換，效率高於 str_replace 數組形式，且不會出現「替換後又被再次替換」的問題。
• 映射表完整性：涵蓋數字、字母、常用中英文標點、特殊符號，基本覆蓋日常業務場景。
• 編碼一致性：確保源文件編碼（建議 UTF-8）與運行環境一致，否則字符無法正確匹配。

擴展：半形轉全形

同理構建反向映射表即可：

function Db2Sbc($str) {
    $arr = array_flip($GLOBALS['sbc2dbc_map']); // 假設映射表為全局變量
    return strtr($str, $arr);
}

總結

通過建立完整的字符映射表並使用 strtr，可穩健解決全半形轉換問題。此法不依賴特定編碼邏輯，兼容性強，適合表單驗證、搜索關鍵詞預處理、數據導入清洗等場景。