萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP ASCII/Unicode 轉換工具類:實體編碼與解碼實現

應用場景

  • 前端傳入數字實體 `中文` 需還原為中文
  • 輸出安全字串,將非 ASCII 字元轉為實體避免編碼問題

完整類別實現

<?php
class AsciiCodec
{
    /**
     * 解碼:數字實體 → UTF-8 字串
     * 支援 〹 (十進制) 和 😀 (十六進制)
     */
    public static function decode(string $str): string
    {
        return preg_replace_callback('/&#(?:x([0-9a-fA-F]+)|(\d+));/', function ($m) {
            $code = isset($m[1]) ? hexdec($m[1]) : intval($m[2]);
            if ($code < 0 || $code > 0x10FFFF) return $m[0];
            return mb_chr($code, 'UTF-8');
        }, $str);
    }

    /**
     * 編碼:UTF-8 字串 → 數字實體 (十進制)
     * 可選擇僅編碼非 ASCII 或全部編碼
     */
    public static function encode(string $str, bool $onlyNonAscii = true): string
    {
        $len = mb_strlen($str, 'UTF-8');
        $out = '';
        for ($i = 0; $i < $len; $i++) {
            $ch = mb_substr($str, $i, 1, 'UTF-8');
            $code = mb_ord($ch, 'UTF-8');
            if ($onlyNonAscii && $code < 128) {
                $out .= $ch;
            } else {
                $out .= "&#{$code};";
            }
        }
        return $out;
    }
}

// 使用示範
$original = '中文 English 123 😀';
$encoded = AsciiCodec::encode($original);
$decoded = AsciiCodec::decode($encoded);
echo "原始: $original\n";
echo "編碼: $encoded\n";
echo "解碼: $decoded\n";
?>

內建函數替代 (PHP 7.0+)

  • `mb_chr($code, 'UTF-8')`:碼位 → 字元
  • `mb_ord($char, 'UTF-8')`:字元 → 碼位
  • `html_entity_decode($str, ENT_QUOTES | ENT_HTML5, 'UTF-8')`:解碼所有 HTML 實體
  • `htmlspecialchars($str, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8')`:編碼特殊字元

效能建議

大量轉換時,優先使用內建 `html_entity_decode`/`htmlspecialchars`,僅在需自定義編碼範圍時使用本類。

copyright © 萬盛學電腦網 all rights reserved