دالة PHP htmlspecialchars ()
مثال
تحويل الأحرف المحددة مسبقًا "<" (أقل من) و ">" (أكبر من) إلى كيانات HTML:
<?php
$str = "This is some <b>bold</b> text.";
echo htmlspecialchars($str);
?>
سيكون ناتج HTML للشفرة أعلاه (عرض المصدر):
<!DOCTYPE html>
<html>
<body>
This is some <b>bold</b> text.
</body>
</html>
سيكون إخراج المتصفح للشفرة أعلاه هو:
This is some <b>bold</b> text.
التعريف والاستخدام
تعمل الدالة htmlspecialchars () على تحويل بعض الأحرف المحددة مسبقًا إلى كيانات HTML.
الأحرف المحددة مسبقًا هي:
- & (علامة العطف) تصبح & amp؛
- "(اقتباس مزدوج) يصبح & quot؛
- (اقتباس واحد) يصبح & # 039 ؛
- <(أقل من) يصبح & lt؛
- > (أكبر من) تصبح & GT ؛
نصيحة: لتحويل كيانات HTML الخاصة مرة أخرى إلى أحرف ، استخدم وظيفة htmlspecialchars_decode () .
بناء الجملة
htmlspecialchars(string,flags,character-set,double_encode)
قيمه المعامل
Parameter | Description |
---|---|
string | Required. Specifies the string to convert |
flags | Optional. Specifies how to handle quotes, invalid encoding and the used document type. The available quote styles are:
Invalid encoding:
Additional flags for specifying the used doctype:
|
character-set | Optional. A string that specifies which character-set to use. Allowed values are:
Note: Unrecognized character-sets will be ignored and replaced by ISO-8859-1 in versions prior to PHP 5.4. As of PHP 5.4, it will be ignored an replaced by UTF-8. |
double_encode | Optional. A boolean value that specifies whether to encode existing html entities or not.
|
تفاصيل تقنية
قيمة الإرجاع: | إرجاع السلسلة المحولة إذا كانت السلسلة تحتوي على ترميز غير صالح ، فستعيد سلسلة فارغة ، ما لم يتم تعيين علامات ENT_IGNORE أو ENT_SUBSTITUTE |
---|---|
إصدار PHP: | 4+ |
التغيير: | PHP 5.6 - تم تغيير القيمة الافتراضية لمعلمة مجموعة الأحرف
إلى قيمة مجموعة الأحرف الافتراضية (في التكوين). PHP 5.4 - تم تغيير القيمة الافتراضية لمعلمة مجموعة الأحرف إلى UTF-8. PHP 5.4 - تمت إضافة ENT_SUBSTITUTE و ENT_DISALLOWED و ENT_HTML401 و ENT_HTML5 و ENT_XML1 و ENT_XHTML PHP 5.3 - تمت إضافة ثابت ENT_IGNORE. PHP 5.2.3 - تمت إضافة معلمة double_encode . PHP 4.1 - تمت إضافة معلمة مجموعة الأحرف . |
مزيد من الأمثلة
مثال
قم بتحويل بعض الأحرف المحددة مسبقًا إلى كيانات HTML:
<?php
$str = "Jane & 'Tarzan'";
echo htmlspecialchars($str, ENT_COMPAT); // Will only convert double quotes
echo "<br>";
echo htmlspecialchars($str, ENT_QUOTES); // Converts double and single quotes
echo "<br>";
echo htmlspecialchars($str, ENT_NOQUOTES); // Does not convert any quotes
?>
سيكون ناتج HTML للشفرة أعلاه (عرض المصدر):
<!DOCTYPE html>
<html>
<body>
Jane & 'Tarzan'<br>
Jane & 'Tarzan'<br>
Jane & 'Tarzan'
</body>
</html>
سيكون إخراج المتصفح للشفرة أعلاه هو:
Jane & 'Tarzan'
Jane & 'Tarzan'
Jane & 'Tarzan'
مثال
تحويل علامات الاقتباس المزدوجة إلى كيانات HTML:
<?php
$str = 'I love "PHP".';
echo htmlspecialchars($str, ENT_QUOTES); // Converts double and single quotes
?>
سيكون ناتج HTML للشفرة أعلاه (عرض المصدر):
<!DOCTYPE html>
<html>
<body>
I love "PHP".
</body>
</html>
سيكون إخراج المتصفح للشفرة أعلاه هو:
I love "PHP".
❮ مرجع سلسلة PHP