html_entity_decode
تابع html_entity_decode «موجودیت های HTML (HTML Entity)» را به نویسه های عادی تبدیل می کند. «موجودیت» نسخه کدیِ حروف خاص است. مثل & که همان & است.
تعریف و کاربرد
این تابع رشته ای با entity می گیرد و متن معمولی برمی گرداند. این کار برای نمایش لینک ها و نقل قول ها ضروری است.
سینتکس
html_entity_decode(string, flags, character-set)
string: رشته ورودی. flags: نحوه دیکد نقل قول ها و داک تایپ. character-set: مجموعه نویسه؛ پیش فرض UTF-8 است.
مثال پایه: تبدیل entity به متن
<?php
$str = '<a href="https://www.w3schools.com">w3schools.com</a>';
echo html_entity_decode($str);
?>
کنترل نقل قول ها با flags
<?php
$str = "Albert Einstein said: 'E=MC²'";
echo html_entity_decode($str, ENT_COMPAT);
echo "<br>";
echo html_entity_decode($str, ENT_QUOTES);
echo "<br>";
echo html_entity_decode($str, ENT_NOQUOTES);
?>
تنظیم مجموعه نویسه (character-set)
<?php
$str = "My name is Øyvind Åsane. I'm Norwegian.";
echo html_entity_decode($str, ENT_QUOTES, "UTF-8");
?>
گام های عملی سریع
- رشته شامل entity را آماده کن.
- فلگ مناسب را انتخاب کن.
- در صورت نیاز، مجموعه نویسه را مشخص کن.
- تابع را صدا بزن و خروجی را چاپ کن.
نکته: برای HTML5 از ENT_HTML5 استفاده کن. برای XML نیز ENT_XML1 مناسب است.
هشدار: اگر کاراکترست ناشناخته باشد، نسخه های جدید آن را نادیده می گیرند و UTF-8 در نظر می گیرند.
لینک های مرتبط داخل سایت
جهت تبدیل entity به متن این صفحه مرجع است. تبدیل برعکس را در htmlentities ببین. جدول نگاشت ها را هم در get_html_translation_table بررسی کن.
جمع بندی سریع
- entity را به متن عادی برمی گرداند.
- فلگ ها نقل قول ها را کنترل می کنند.
- UTF-8 انتخاب امن و پیش فرض است.
- برای HTML5 از ENT_HTML5 استفاده کن.