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

為什麼不使用 ASCII 運算？

網上常見「減去 65248」的 ASCII 差值法，僅適用於基本拉丁字母區塊（U+FF01~U+FF5E），對於全角括號、標點、特殊符號（如全角空格 U+3000、波浪號 U+FF5E 等）會產生錯誤映射。最穩妥的方案是建立完整映射表逐字符替換。

Sbc2Dbc 函數完整實現

<?php
/**
 * 全角字符轉半角
 * @param string $str 輸入字符串
 * @return string 轉換後字符串
 */
function Sbc2Dbc(string $str): string {
    static $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);
// 輸出: PHP 全角转半角 测试123!@#$%

性能優化提示

1. 靜態變量緩存映射表：避免重複構建陣列，首次調用後常駐內存。
2. 使用 strtr 而非 str_replace：strtr 以字符為單位一次性替換，不會產生嵌套替換問題，速度更快。
3. 批量處理時：可結合 array_map('Sbc2Dbc', $data) 對陣列批量轉換。

反向轉換（半角轉全角）

只需交換映射表的鍵值對，或構建獨立 Dbc2Sbc 函數，邏輯完全對稱。