مثال
تحويل الأحرف محددة مسبقا "<" (less than) و ">" (greater than) إلى كيانات HTML:
<?php
$str = "This is some <b>bold</b> text.";
echo htmlspecialchars($str);
?>
إخراج HTML من التعليمات البرمجية أعلاه سيكون (View Source) :
<!DOCTYPE html>
<html>
<body>
This is some <b>bold</b> text.
</body>
</html>
إخراج المتصفح من التعليمات البرمجية أعلاه سيكون:
This is some <b>bold</b> text.
تشغيل المثال » تعريف والاستخدام
و htmlspecialchars() وظيفة تحويل بعض الأحرف محددة مسبقا إلى كيانات HTML.
شخصيات محددة مسبقا هي:
- و (ampersand) يصبح اند
- " (double quote) يصبح ومثل.
- " (single quote) يصبح & # 039؛
- < (less than) يصبح العلامة & lt؛
- > (greater than) يصبح وGT.
تلميح: لتحويل الكيانات HTML خاصة إلى الأحرف، استخدم htmlspecialchars_decode() وظيفة.
بناء الجملة
htmlspecialchars( string,flags,character-set,double_encode )
معامل | وصف |
---|---|
string | مطلوب. تحدد سلسلة لتحويل |
flags | اختياري. تحدد كيفية التعامل مع ونقلت وترميز صالح وتستخدم نوع المستند. أنماط اقتبس المتاحة هي:
ترميز صالح:
أعلام إضافية لتحديد نوع المستند المستخدمة:
|
character-set | اختياري. سلسلة التي تحدد حرف تعيين لاستخدام. القيم المسموح بها هي:
Note: سيتم تجاهل غير المعترف بها حرف مجموعات والاستعاضة عنها ISO-8859-1 في الإصدارات السابقة إلى PHP 5.4. اعتبارا من PHP 5.4، سيتم تجاهله واستبداله UTF-8. |
double_encode | اختياري. قيمة منطقية تحدد ما إذا كان لترميز الكيانات أتش تي أم أل القائمة أم لا.
|
تفاصيل تقنية
قيمة الإرجاع: | إرجاع سلسلة المحولة إذا احتوت سلسلة ترميز غير صالح، فإنه سيعود سلسلة فارغة، إلا إذا تم تعيين إما ENT_IGNORE أو الأعلام ENT_SUBSTITUTE |
---|---|
صفحة PHP: | 4+ |
التغيير: | تم تغيير القيمة الافتراضية للمعلمة مجموعة الأحرف إلى UTF-8 في PHP 5 أضيفت ENT_SUBSTITUTE، ENT_DISALLOWED، ENT_HTML401، ENT_HTML5، ENT_XML1 وENT_XHTML في PHP 5.4 وأضاف ENT_IGNORE في PHP 5.3 تمت إضافة المعلمة double_encode في PHP 5.2.3 تمت إضافة المعلمة مجموعة الأحرف في PHP 4.1 |
مزيد من الأمثلة
مثال 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 من التعليمات البرمجية أعلاه سيكون (View Source) :
<!DOCTYPE html>
<html>
<body>
Jane & 'Tarzan'<br>
Jane & 'Tarzan'<br>
Jane & 'Tarzan'
</body>
</html>
إخراج المتصفح من التعليمات البرمجية أعلاه سيكون:
Jane & 'Tarzan'
Jane & 'Tarzan'
Jane & 'Tarzan'
تشغيل المثال » مثال 2
تحويل التنصيص على الكيانات HTML:
<?php
$str = 'I love "PHP" .';
echo htmlspecialchars($str, ENT_QUOTES);
// Converts double and single quotes
?>
إخراج HTML من التعليمات البرمجية أعلاه سيكون (View Source) :
<!DOCTYPE html>
<html>
<body>
I love "PHP".
</body>
</html>
إخراج المتصفح من التعليمات البرمجية أعلاه سيكون:
I love "PHP" .
تشغيل المثال » <PHP سلسلة المرجعي