PHP html_entity_decode()函数详解
在PHP开发中，处理HTML实体与普通字符之间的转换是一项常见的任务。当我们在网页上需要原样显示HTML标签时，通常会将特殊字符转换为HTML实体（例如将 < 转换为 <）。而当我们需要将这些HTML实体还原为原本的字符时，PHP提供了非常实用的内置函数 html_entity_decode()。
一、函数基本介绍
html_entity_decode() 函数的作用是将字符串中的HTML实体转换为对应的字符。它是 htmlentities() 函数的逆操作。与 htmlspecialchars_decode() 只解码少数几个特殊字符不同，html_entity_decode() 会解码所有的HTML实体。
二、函数语法
html_entity_decode(string $string, int $flags = ENT_QUOTES | ENT_SUBSTITUTE, ?string $encoding = null): string
参数详解
$string：必需。要解码的字符串。
$flags：可选。指定如何处理引号以及使用哪种文档类型。默认值是
ENT_QUOTES | ENT_SUBSTITUTE。$encoding：可选。指定解码时使用的字符编码。如果省略，则默认使用 PHP 的 default_charset 配置选项的值。
常用的 flags 常量
| 常量名称 | 说明 |
|---|---|
| ENT_COMPAT | 转换双引号，不转换单引号。 |
| ENT_QUOTES | 转换双引号和单引号。 |
| ENT_NOQUOTES | 不转换任何引号。 |
| ENT_HTML401 | 作为 HTML 4.01 处理代码。 |
| ENT_XML1 | 作为 XML 1 处理代码。 |
| ENT_XHTML | 作为 XHTML 处理代码。 |
| ENT_HTML5 | 作为 HTML 5 处理代码。 |
三、基础使用示例
下面通过一个简单的例子，演示如何将包含HTML实体的字符串还原为HTML标签。
<?php $str = "<p>这是一个段落</p>"; echo "解码前: " . $str . "<br>"; // 进行解码 $decodedStr = html_entity_decode($str); echo "解码后: " . $decodedStr; ?>
上述代码的输出结果为：
解码前: <p>这是一个段落</p> 解码后:这是一个段落
在解码后，浏览器会识别 <p> 标签并将其作为段落渲染，而不是直接显示标签文本。
四、引号与编码处理示例
在实际开发中，处理引号和不同语言的字符编码是经常遇到的场景。
<?php // 示例1：处理引号 $str1 = "I "will" go 'home'"; // 默认ENT_QUOTES，单双引号都会解码 echo html_entity_decode($str1, ENT_QUOTES) . "<br>"; // ENT_NOQUOTES，单双引号都不解码 echo html_entity_decode($str1, ENT_NOQUOTES) . "<br>"; // 示例2：处理不同编码的字符实体 $str2 = "中文"; // 指定UTF-8编码解码 echo html_entity_decode($str2, ENT_QUOTES, "UTF-8"); ?>
输出结果：
I "will" go 'home' I "will" go 'home' 中文
五、与 htmlspecialchars_decode() 的区别
许多开发者容易混淆 html_entity_decode() 和 htmlspecialchars_decode()。它们的核心区别在于解码的范围：
htmlspecialchars_decode()：只解码少数几个特定的HTML实体，即&、<、>、"和'（如果启用了 ENT_QUOTES）。html_entity_decode()：解码所有的HTML实体，包括像©（版权符号）、®（注册商标）、€（欧元符号）等所有的命名和数字实体。
示例对比：
<?php $str = "© 2023 & <test>"; // htmlspecialchars_decode 不会转换 © echo htmlspecialchars_decode($str) . "<br>"; // html_entity_decode 会转换所有实体 echo html_entity_decode($str); ?>
输出结果：
© 2023 &© 2023 &
六、实际应用场景
富文本编辑器内容回显：当用户通过富文本编辑器提交内容时，数据可能被编码为HTML实体存入数据库。在需要将内容导出为非HTML格式（如纯文本邮件、PDF文档）时，需要使用该函数解码。
API数据交互：在接收第三方API返回的JSON或XML数据时，如果数据中包含了转义的HTML实体，可以使用此函数将其还原，以便前端或本地程序正确处理。例如，请求接口 https://www.ipipp.com/api/data 返回的描述字段可能包含实体。
数据清洗：在进行字符串搜索、替换或分词前，将HTML实体还原为原始字符，可以保证文本处理的准确性。
七、注意事项
一定要根据实际应用环境选择正确的字符编码参数，尤其是处理多字节字符（如中文）时，建议显式传入
UTF-8，否则可能出现乱码。解码后的字符串如果直接输出到网页，包含的HTML标签会被浏览器解析执行。如果内容来自不可信的用户输入，请务必防范XSS（跨站脚本攻击），确保在解码前或输出时进行必要的安全过滤。
多次对同一字符串调用
html_entity_decode()不会产生副作用，因为已经被解码的字符不会再被重复解码。
html_entity_decodePHP函数HTML实体解码字符编码htmlspecialchars_decode区别