PHP将非ASCII字符转换为HTML数字实体引用的类实现

Cora

发布时间：2026-10-14| 3人浏览过

原创

在Web开发中，有时需要将包含特殊字符或中文的字符串转换为HTML实体引用，以防止解析错误或提升安全性。本文将介绍一个自定义PHP类 HtmlEncode，它能够自动将非ASCII字符转换为HTML数字实体格式（如我），并保留原有逻辑的核心功能。

实现原理与核心代码

该方案的核心在于识别字符串中的非ASCII字符，并将其对应的Unicode值转换为HTML实体。类 HtmlEncode 使用了静态方法和正则表达式回调来实现这一过程。

class HtmlEncode {
    static $_convertToHtmlEntitiesSrcEncoding = 'UTF-8';

    /**
* 将非ASCII字符串转换成HTML实体
* @param string $s 要进行编码的字符串
* @param string $srcEncoding 源字符编码，默认为UTF-8
* @return string 返回HTML实体引用
*/
    public static function encode($s, $srcEncoding = 'UTF-8') {
        self::$_convertToHtmlEntitiesSrcEncoding = $srcEncoding;
        // 使用正则匹配所有非ASCII字符
        return preg_replace_callback('|[^\x00-\x7F]+|', array(__CLASS__, '_convertToHtmlEntities'), $s);
    }

    private static function _convertToHtmlEntities($data) {
        if (is_array($data)) {
            $chars = str_split(iconv(self::$_convertToHtmlEntitiesSrcEncoding, "UCS-2BE", $data[0]), 2);
            $chars = array_map(array(__CLASS__, __FUNCTION__), $chars);
            return join("", $chars);
        } else {
            // 获取双字节并转换为十六进制，再转为十进制整数
            $code = hexdec(sprintf("%02s%02s;", dechex(ord($data {0})), dechex(ord($data {1}))) );
            return sprintf("&#%s;", $code);
        }
    }
}

使用步骤与示例

第1步：定义并使用 encode 方法

直接调用 HtmlEncode::encode() 传入目标字符串。该方法会自动处理内部的编码转换逻辑。

入口：HtmlEncode::encode(string $str [, string $encoding])
动作：输入包含中文或其他非ASCII字符的文本。
结果：函数返回经过编码处理的字符串，其中的中文被替换为对应的数字实体。

示例：

$output = HtmlEncode::encode("我信了");
echo $output; // 输出: 我信了

第2步：验证转换结果

在浏览器中展示上述输出的字符串，通常浏览器会将其正确渲染为原始字符“我信了”。这种转换方式常用于数据传递或存储前的预处理，确保内容在不同环境下的兼容性与防注入能力。

注意事项与排错

性能开销：由于涉及多次正则匹配和数组映射，处理极长文本时可能产生一定性能负担。
编码一致性：确保输入字符串的编码（如UTF-8）与类内部设定的 $_convertToHtmlEntitiesSrcEncoding 一致，否则可能出现乱码。
PHP版本差异：代码中使用的语法（如 $data {0}）在某些较新的PHP版本中可能被弃用，建议在实际项目中测试兼容性。

以上就是PHP中将非ASCII字符串转换为HTML实体引用的详细内容，更多关于PHP字符编码技巧的资料请关注本站其它相关文章！