PHP 全角轉半角函數：完整字符映射表與高性能實現

處理用戶輸入（如表單、導入數據）時，全角字符常導致查詢失配、驗證失效。本文提供一個開箱即用的 Sbc2Dbc() 函數，覆蓋數字、字母、標點、特殊符號的完整映射，並討論性能優化與擴展策略。

完整映射表實現

<?php
function Sbc2Dbc(string $str): string {
    static $map = null;
    if ($map === null) {
        $map = [
            // 數字
            '０' => '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',
            // 標點符號
            '（' => '(', '）' => ')', '〔' => '(', '〕' => ')',
            '【' => '[', '】' => ']', '〖' => '[', '〗' => ']',
            '「' => '"', '」' => '"', '『' => "'", '』' => "'",
            '｛' => '{', '｝' => '}', '《' => '<', '》' => '>',
            '％' => '%', '＋' => '+', '—' => '-', '－' => '-', '～' => '~',
            '：' => ':', '。' => '.', '、' => ',', '，' => ',', '；' => ';',
            '？' => '?', '！' => '!', '…' => '...', '‖' => '|',
            '＂' => '"', '＇' => "'", '｜' => '|', '〃' => '""',
            '￥' => '$', '＝' => '=', '＼' => '\\', '／' => '/',
            // 空格
            '　' => ' ', // 全角空格 U+3000
        ];
    }
    return strtr($str, $map);
}

使用示例

$input = "Ｈｅｌｌｏ　Ｗｏｒｌｄ！　Ｐｒｉｃｅ：￥１０００。";
echo Sbc2Dbc($input);
// 輸出: Hello World! Price: $1000.

性能優化要點

1. 靜態變量緩存映射表： 避免每次調用重複構建數組（原文直接在函數內定義數組，每次調用都會重新分配內存）。
2. 使用 strtr 而非 str_replace： strtr 以字符為單位一次性替換，複雜度 O(n)；str_replace 遍歷數組鍵名，多次掃描字符串，慢 3-5 倍。
3. 批量處理： 若需處理大量數據（如 CSV 導入），可用 array_map('Sbc2Dbc', $rows) 或流式處理逐行轉換。

擴展：基於 Unicode 正規化的通用方案

若需覆蓋映射表外的稀有全角字符（如全角希臘字母、羅馬數字等），可結合 Normalizer（intl 擴展）：

if (class_exists('Normalizer')) {
    $str = Normalizer::normalize($str, Normalizer::FORM_KC); // 兼容性分解，全角→半角
}

注意：FORM_KC 會同時處理連字符、上標下標等，可能改變語義，建議先用映射表精確控制，再輔以正規化兜底。

反向操作：半角轉全角

function Db2Sbc(string $str): string {
    static $map = null;
    if ($map === null) {
        $map = array_flip([
            // 這裡填寫上述 $map 的所有鍵值對，或直接手寫反向數組
        ]);
    }
    return strtr($str, $map);
}

將 Sbc2Dbc 放入公共工具類，在表單驗證、搜索關鍵字預處理、數據入庫前統一調用，能消除 90% 以上因全半角不一致導致的業務 Bug。