表单中的 HTML 实体怎么还原？用 html_entity_decode 快速搞定

gitbox 2025-09-02

HTML 实体是什么？

HTML实体是一些字符的编码形式，通常以 & 开头，以 ; 结束。常见的HTML实体包括：

< 对应 <
> 对应 >
& 对应 &
" 对应 "
  对应空格

这些实体通常用于防止某些字符在HTML中引起语法错误或影响页面渲染。当表单数据通过HTTP请求提交时，这些字符可能会被转换成实体，以确保其正确传输。

为什么需要还原 HTML 实体？

当表单数据被用户提交到服务器时，特殊字符常常被转义为HTML实体。这种转义虽然有助于安全性（避免恶意脚本注入），但有时我们需要还原这些实体，以便正确显示原始内容。比如，如果用户输入了一段包含 < 和 > 的HTML标签，并且该标签被转义成了 < 和 >，我们可能希望还原为实际的字符，以便在页面中正确展示。

如何使用 html_entity_decode() 还原 HTML 实体？

html_entity_decode() 是 PHP 提供的一个内置函数，主要用于将HTML实体转换为相应的字符。其基本用法如下：

<span><span><span class="hljs-variable">$string</span></span><span> = </span><span><span class="hljs-string">"Hello &amp;lt;world&amp;gt;!"</span></span><span>;
</span><span><span class="hljs-variable">$decoded_string</span></span><span> = </span><span><span class="hljs-title function_ invoke__">html_entity_decode</span></span><span>(</span><span><span class="hljs-variable">$string</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$decoded_string</span></span><span>;
</span></span>

输出：

<span><span><span class="language-xml">Hello <span class="hljs-tag">&lt;<span class="hljs-name">world</span></span></span></span><span>&gt;!
</span></span>

如上所示，html_entity_decode() 将 < 和 > 还原为 < 和 >。

函数参数详解：

html_entity_decode($string, $flags, $encoding)：
- $string：要处理的字符串，包含需要转换的HTML实体。
- $flags：可选参数，用于控制转换过程。常用的标志有：
  - ENT_COMPAT（默认）：只转换双引号，不转换单引号。
  - ENT_QUOTES：转换双引号和单引号。
  - ENT_NOQUOTES：不转换任何引号。
- $encoding：可选参数，指定字符编码，默认为 UTF-8。

示例：将所有引号还原

如果你希望还原字符串中的所有HTML实体，包括单引号和双引号，可以使用 ENT_QUOTES 标志：

<span><span><span class="hljs-variable">$string</span></span><span> = </span><span><span class="hljs-string">"It&amp;apos;s a &amp;quot;great&amp;quot; day!"</span></span><span>;
</span><span><span class="hljs-variable">$decoded_string</span></span><span> = </span><span><span class="hljs-title function_ invoke__">html_entity_decode</span></span><span>(</span><span><span class="hljs-variable">$string</span></span><span>, ENT_QUOTES);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$decoded_string</span></span><span>;
</span></span>

输出：

<span><span>It</span><span><span class="hljs-symbol">'s</span></span><span> a </span><span><span class="hljs-string">"great"</span></span><span> day!
</span></span>

在表单处理中的应用

假设你有一个表单，用户输入了包含HTML实体的文本，提交到服务器后，服务器端收到的文本可能已经是转义过的HTML实体。你需要在展示表单结果时将这些实体还原。使用 html_entity_decode() 就能轻松实现这一功能。

示例：表单数据处理

<span><span><span class="hljs-comment">// 假设接收到的表单数据已经进行了HTML实体转义</span></span><span>
</span><span><span class="hljs-variable">$submitted_data</span></span><span> = </span><span><span class="hljs-string">"Hello &amp;lt;strong&amp;gt;world&amp;lt;/strong&amp;gt;!"</span></span><span>;
</span><span><span class="hljs-variable">$decoded_data</span></span><span> = </span><span><span class="hljs-title function_ invoke__">html_entity_decode</span></span><span>(</span><span><span class="hljs-variable">$submitted_data</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$decoded_data</span></span><span>;
</span></span>

输出：

<span><span>Hello &lt;</span><span><span class="hljs-selector-tag">strong</span></span><span>&gt;world&lt;/</span><span><span class="hljs-selector-tag">strong</span></span><span>&gt;!
</span></span>

通过 html_entity_decode()，原本被转义的HTML实体得以还原，内容也就可以正确展示了。

总结

在开发表单时，HTML实体的转义和还原是非常常见的需求，尤其是在处理用户输入的内容时。html_entity_decode() 函数提供了一种简单而高效的方法来将HTML实体转换回其对应的字符，帮助开发者在表单处理和数据展示中更好地控制内容的呈现。

通过合理使用 html_entity_decode()，你可以确保用户提交的文本在还原后能够正确展示，避免因HTML实体造成的显示错误或其他问题。

相关标签:
HTML

html_entity_decode