PHP 全角半角字符互轉：四種方案對比 (正則替換、映射表、回調函數、strtr 高性能)

PHP 全角半角字符互轉：四種方案對比 (正則替換、映射表、回調函數、strtr 高性能)

全角字符 (全形) 佔用兩字節，半角佔用一字節，常見於用戶輸入標準化、搜索關鍵詞預處理、數據清洗。本文提供四種 PHP 實現方案，從簡單正則到高性能查表，附 Unicode 碼位對照表。

方案一：正則替換 (僅限非 UTF-8 / 單字節編碼)

$str = "０１２３ＡＢＣＤＦＷＳ＼＂，．？＜＞｛｝［］＊＆＾％＃＠！～（）＋－｜：；";
// 非 UTF-8 環境下：第二字節 - 0x80 得到半角
$str = preg_replace('/\xa3([\xa1-\xfe])/e', 'chr(ord("\\1")-0x80)', $str);
echo $str; // 0123ABCDFWS\".<>[]*&^%#@!~()+-|:;
// 注意：/e 修飾符 PHP 7.1+ 棄用，UTF-8 下無效

原理：GBK/Big5 編碼中，全角字符第二字節 = 半角字符碼位 + 0x80。UTF-8 編碼無此規律。

方案二：映射表 + preg_replace_callback (UTF-8 兼容)

$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',
];

$str = preg_replace_callback(
    '/[\xEF][\xBC][\x90-\x99]|[\xEF][\xBD][\x81-\x9A\xA1-\xBA]/',
    fn($m) => $map[$m[0]] ?? $m[0],
    $str
);

原理：UTF-8 中全角數字 U+FF10~FF19 編碼為 EF BC 90~99，大寫字母 U+FF21~FF3A 為 EF BD 81~9A，小寫 U+FF41~FF5A 為 EF BD A1~BA。

方案三：雙向映射數組 + str_replace (通用、可維護)

function convertStrType(string $str, string $type): string {
    $full = ['０','１','２','３','４','５','６','７','８','９',
        'Ａ','Ｂ','Ｃ','Ｄ','Ｅ','Ｆ','Ｇ','Ｈ','Ｉ','Ｊ','Ｋ','Ｌ','Ｍ','Ｎ','Ｏ','Ｐ','Ｑ','Ｒ','Ｓ','Ｔ','Ｕ','Ｖ','Ｗ','Ｘ','Ｙ','Ｚ',
        'ａ','ｂ','ｃ','ｄ','ｅ','ｆ','ｇ','ｈ','ｉ','ｊ','ｋ','ｌ','ｍ','ｎ','ｏ','ｐ','ｑ','ｒ','ｓ','ｔ','ｕ','ｖ','ｗ','ｘ','ｙ','ｚ',
        '－','　','：','．','，','／','％','＃','！','＠','＆','（','）','＜','＞','＂','＇','？','［','］','｛','｝','＼','｜','＋','＝','＿','＾','￥','￣','｀'];
    $half = ['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 ($type === 'TO_DBC') // 全角轉半角
        ? str_replace($full, $half, $str)
        : str_replace($half, $full, $str); // 半角轉全角
}

方案四：strtr 單次遍歷最高性能 (推薦生產)

function makeSemiangle(string $str): string {
    $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',
        // 標點符號 (常用)
        '（'=>'(', '）'=>')', '〔'=>'[', '〕'=>']', '【'=>'[', '】'=>']', '〖'=>'[', '〗'=>']',
        '“'=>'"', '”'=>'"', '‘'=>"'", '’'=>"'", '《'=>'<', '》'=>'>',
        '％'=>'%', '＋'=>'+', '—'=>'-', '－'=>'-', '～'=>'~', '：'=>':', '。'=>'.', '、'=>',', '，'=>',', '；'=>';',
        '？'=>'?', '！'=>'!', '…'=>'...', '‖'=>'|', '｜'=>'|', '〃'=>'"', '　'=>' '
    ];
    return strtr($str, $map);
}

性能對比 (10萬次循環，字符串長度 200)

全角半角 Unicode 碼位對照 (核心子集)

最佳實踐建議

1. 統一使用 UTF-8 編碼 (文件、數據庫、HTML、連接)
2. 輸入端統一調用 makeSemiangle() 標準化 3. 搜索引擎索引前同步轉換，保證全半角混合查詢命中 4. 正則匹配時使用 /u 修飾符正確處理 Unicode 5. 數據庫列設置 utf8mb4_general_ci 排序規則，原生支持全半角不敏感比較

掌握 Unicode 編碼規律，選擇 strtr 方案，即可高效解決全半角混雜帶來的業務 Bug。