PHP html_entity_decode() 函数

实例

把预定义的 HTML 实体 "<"(小于)和 ">"(大于)转换为字符:

<?php
$str = "This is some bold text.";
echo htmlspecialchars_decode($str);
?>

خروجی HTML کد بالا به شرح زیر است (منبع کد را مشاهده کنید):

<!DOCTYPE html>
<html>
<body>
This is some bold text.
</body>
</html>

خروجی مرورگر کد بالا به شرح زیر است:

This is some bold text.

定义和用法

htmlspecialchars_decode() 函数把预定义的 HTML 实体转换为字符。

会被解码的 HTML 实体是:

  • & 解码成 & (和号)
  • " 解码成 " (双引号)
  • ' 解码成 ' (单引号)
  • < 解码成 < (小于)
  • > 解码成 > (大于)

htmlspecialchars_decode() 函数是 htmlspecialchars() 函数的反函数。

语法

htmlspecialchars_decode(string,flags)
参数 描述
string 必需。规定要解码的字符串。
flags

可选。规定如何处理引号以及使用哪种文档类型。

可用的引号类型:

  • ENT_COMPAT - دفعتی طور پر. صرف دو قوسوں کو ڈکوڈ کرنا.
  • ENT_QUOTES - دو قوسوں اور ایک کوئی کو ڈکوڈ کرنا.
  • ENT_NOQUOTES - کسی بھی کوئی کو نہیں ڈکوڈ کرنا.

استفاده کئے جانے والی ڈوکومنٹ کی نوعیت کی اضافی فلاگز:

  • ENT_HTML401 - دفعتی طور پر. کے طور پر HTML 4.01 کو پروسیس کرنا.
  • ENT_HTML5 - کے طور پر HTML 5 کو پروسیس کرنا.
  • ENT_XML1 - کے طور پر XML 1 کو پروسیس کرنا.
  • ENT_XHTML - کے طور پر XHTML کو پروسیس کرنا.

جزئیات فنی

مقدار بازگردانده شده: رشته تبدیل شده را بازگرداند.
نسخه PHP: 5.1.0+
رویدادهای به‌روزرسانی:

در PHP 5.4، flags اضافی برای تعیین نوع مستند استفاده شده اضافه شده است:

  • ENT_HTML401
  • ENT_HTML5
  • ENT_XML1
  • ENT_XHTML

مثال‌های بیشتر

مثال 1

تبدیل entity‌های HTML پیش‌تعریف شده به کاراکترها

<?php
$str = "Bill & 'Steve'";
echo htmlspecialchars_decode($str, ENT_COMPAT); // فقط اعداد دو تایی را تبدیل کند
echo "<br>";
echo htmlspecialchars_decode($str, ENT_QUOTES); // تبدیل اعداد دو تایی و یک تایی
echo "<br>";
echo htmlspecialchars_decode($str, ENT_NOQUOTES); // هیچ نوع اعداد دو تایی و یک تایی را تبدیل نکند
?>

خروجی HTML کد بالا به شرح زیر است (منبع کد را مشاهده کنید):

<!DOCTYPE html>
<html>
<body>
Bill & 'Steve'<br>
Bill & 'Steve'<br>
Bill & 'Steve'
</body>
</html>

خروجی مرورگر کد بالا به شرح زیر است:

Bill & 'Steve'
Bill & 'Steve'
Bill & 'Steve'

مثال 2

تبدیل实体‌های HTML پیش‌تعریف شده به اعداد دو تایی

<?php
$str = 'I love "PHP".';
echo htmlspecialchars_decode($str, ENT_QUOTES); // تبدیل اعداد دو تایی و یک تایی
?>

خروجی HTML کد بالا به شرح زیر است (منبع کد را مشاهده کنید):

<!DOCTYPE html>
<html>
<body>
من "PHP" را دوست دارم.
</body>
</html>

خروجی مرورگر کد بالا به شرح زیر است:

من "PHP" را دوست دارم.