<?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";
?>
大量轉換時,優先使用內建 `html_entity_decode`/`htmlspecialchars`,僅在需自定義編碼範圍時使用本類。