PHP实现Unicode编码与解码转换工具代码

远山来客

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

原创

在开发过程中，特别是在处理前端JSON数据或与不支持直接传递Unicode的旧系统交互时，经常需要将中文字符转换为\uXXXX格式的Unicode编码字符串，或将此类字符串还原。本文将分享一段可靠的PHP代码，包含`unicode_encode`和`unicode_decode`两个核心函数，帮助您快速实现这一转换需求。

转换逻辑与准备

实现Unicode编码的核心在于理解字符集的底层表示。PHP内置了强大的iconv函数用于不同字符集之间的转换，配合base_convert进制转换及正则匹配，即可完成从UTF-8到UCS-2再映射到Unicode转义序列的全过程。

以下代码无需额外引入第三方库，直接在您的项目中定义即可使用。

第1步：定义Unicode编码函数

此步骤目的是将包含中文的UTF-8字符串转换为标准的\uXXXX格式字符串。主要用于数据加密存储或符合特定API规范的输出。

<?php
function unicode_encode($name)
{
    // 首先将UTF-8转为UCS-2（通常对应内部字节序）
    $name = iconv('UTF-8', 'UCS-2', $name);
    $len = strlen($name);
    $str = '';
    
    // 遍历双字节序列
    for ($i = 0; $i < $len - 1; $i = $i + 2)
    {
        $c = $name[$i];
        $c2 = $name[$i + 1];
        
        // ord($c) > 0 判断是否为中文字符部分
        if (ord($c) > 0)
        {   // 两个字节的文字
            // base_convert转为十六进制并补零
            $str .= '\u'.base_convert(ord($c), 10, 16).str_pad(base_convert(ord($c2), 10, 16), 2, 0, STR_PAD_LEFT);
        }
        else
        {
            $str .= $c2;
        }
    }
    return $str;
}

第2步：定义Unicode解码函数

此步骤目的是将带有\u前缀的字符串重新解析，恢复为用户可读的原始UTF-8字符。这在接收第三方接口返回数据或处理数据库存入的转义字符时非常有用。

// 将UNICODE编码后的内容进行解码
function unicode_decode($name)
{
    // 转换编码，将Unicode编码转换成可以浏览的utf-8编码
    // 匹配普通字符或 \uXXXX 格式的转义序列
    $pattern = '/([\w]+)|(\\\u([\w]{4}))/i';
    preg_match_all($pattern, $name, $matches);
    
    if (!empty($matches))
    {
        $name = '';
        for ($j = 0; $j < count($matches[0]); $j++)
        {
            $str = $matches[0][$j];
            
            // 检查是否为Unicode转义序列
            if (strpos($str, '\\u') === 0)
            {
                $code = base_convert(substr($str, 2, 2), 16, 10);
                $code2 = base_convert(substr($str, 4), 16, 10);
                $c = chr($code).chr($code2);
                // 将UCS-2转回UTF-8
                $c = iconv('UCS-2', 'UTF-8', $c);
                $name .= $c;
            }
            else
            {
                // 非转义字符原样保留
                $name .= $str;
            }
        }
    }
    return $name;
}
?>