تحويل بعض الأحرف إلى كيانات HTML:
<?php$str = "<© W3CSçh°°¦§>";echo htmlentities($str);?>مخرجات HTML للكود أعلاه هي كما يلي (عرض الكود المصدري):
<!DOCTYPE html><html><body><©h°¦§></body></html>مخرجات المتصفح للكود أعلاه هي كما يلي:
<© W3CSçh°°¦§>تقوم الدالة htmlentities() بتحويل الأحرف إلى كيانات HTML.
نصيحة: لتحويل كيانات HTML مرة أخرى إلى أحرف، استخدم الدالة html_entity_decode().
نصيحة: استخدم الدالة get_html_translation_table() لإرجاع جدول الترجمة المستخدم بواسطة htmlentities().
htmlentities ( سلسلة، أعلام، مجموعة أحرف، ترميز مزدوج )
| المعلمة | يصف |
|---|---|
| خيط | مطلوب. يحدد السلسلة المراد تحويلها. |
| أعلام | خياري. يحدد كيفية التعامل مع علامات الاقتباس والترميزات غير الصالحة ونوع المستند الذي سيتم استخدامه. أنواع الاقتباس المتاحة: ENT_COMPAT - الافتراضي. يتم ترميز علامات الاقتباس المزدوجة فقط. ENT_QUOTES - يشفر علامات الاقتباس المزدوجة والمفردة. ENT_NOQUOTES - لا تقم بتشفير أي علامات اقتباس. ترميز غير صالح: ENT_IGNORE - تجاهل الترميزات غير الصالحة بدلاً من جعل الوظيفة ترجع سلسلة فارغة. وينبغي تجنب ذلك لأن هذا قد يكون له تأثير على الأمن. ENT_SUBSTITUTE - يستبدل ترميزًا غير صالح بالحرف المحدد بحرف Unicode البديل U+FFFD (UTF-8) أو &#FFFD؛ ENT_DISALLOWED - يستبدل نقاط التعليمات البرمجية غير الصالحة في نوع المستند المحدد بأحرف Unicode البديلة U+FFFD (UTF-8) أو &#FFFD;. علامات إضافية تحدد نوع المستند المطلوب استخدامه: ENT_HTML401 - افتراضي. تتم معالجة التعليمات البرمجية كـ HTML 4.01. ENT_HTML5 - الكود الذي تمت معالجته كـ HTML 5. ENT_XML1 - تمت معالجة التعليمات البرمجية كـ XML 1. ENT_XHTML - كرمز معالجة XHTML. |
| مجموعة الأحرف | خياري. سلسلة تحدد مجموعة الأحرف المراد استخدامها. القيم المسموح بها: UTF-8 - افتراضي. ASCII متوافق مع Unicode متعدد البايت 8 بت ISO-8859-1 - أوروبا الغربية ISO-8859-15 - أوروبا الغربية (رمز اليورو المضاف + الحروف الفرنسية والفنلندية مفقودة من ISO-8859-1) cp866 - مجموعة الأحرف السيريلية الخاصة بـ DOS cp1251 - مجموعة الأحرف السيريلية الخاصة بنظام التشغيل Windows cp1252 - مجموعة أحرف أوروبا الغربية الخاصة بنظام التشغيل Windows KOI8-R - روسي BIG5 - الصينية التقليدية، وتستخدم بشكل رئيسي في تايوان GB2312 - مجموعة الأحرف الصينية المبسطة والمعايير الوطنية BIG5-HKSCS - Big5 بامتداد هونج كونج Shift_JIS - اليابانية EUC-JP - اليابانية MacRoman - مجموعة الأحرف التي يستخدمها نظام التشغيل Mac ملاحظة: في الإصدارات السابقة لـ PHP 5.4، تم تجاهل مجموعات الأحرف غير المعروفة واستبدالها بـ ISO-8859-1. اعتبارًا من PHP 5.4، يتم تجاهل مجموعات الأحرف غير المعروفة واستبدالها بـ UTF-8. |
| double_encode | خياري. قيمة منطقية تحدد ما إذا كان سيتم تشفير كيانات HTML الموجودة أم لا. صحيح - افتراضي. سيتم تحويل كل كيان. خطأ - لن يتم ترميز كيانات HTML الموجودة. |
| قيمة الإرجاع: | إرجاع السلسلة المحولة. إذا كانت السلسلة تحتوي على ترميز غير صالح، فسيتم إرجاع سلسلة فارغة ما لم يتم تعيين علامة ENT_IGNORE أو ENT_SUBSTITUTE. |
|---|---|
| نسخة PHP: | 4+ |
| سجل التحديث: | في PHP 5، تغيرت القيمة الافتراضية لمعلمة مجموعة الأحرف إلى 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 htmlentities($str, ENT_COMPAT); // سيتم تحويل علامات الاقتباس المزدوجة فقط "<br>";echo htmlentities($str, ENT_QUOTES); علامات اقتباس مفردة "<br>";echo htmlentities($str, ENT_NOQUOTES); // لا يتم تحويل أي علامات اقتباس؟>مخرجات HTML للكود أعلاه هي كما يلي (عرض الكود المصدري):
<!DOCTYPE html><html><body>جين و'طرزان'<br>جين و'طرزان'<br>جين و'طرزان'</body></html>مخرجات المتصفح للكود أعلاه هي كما يلي:
جين و"طرزان"جين و"طرزان"جين و"طرزان"تحويل بعض الأحرف إلى كيانات HTML باستخدام مجموعة الأحرف الأوروبية الغربية:
<?php$str = "اسمي Øyvind Åsane. أنا نرويجي.";echo htmlentities($str, ENT_QUOTES, "ISO-8859-1"); // سيتم تحويل علامات الاقتباس المزدوجة فقط (وليس علامات الاقتباس المفردة), ويستخدم مجموعة الأحرف الأوروبية الغربية؟>مخرجات HTML للكود أعلاه هي كما يلي (عرض الكود المصدري):
<!DOCTYPE html><html><body>اسمي Øyvind Åsane وأنا نرويجي.</body></html>مخرجات المتصفح للكود أعلاه هي كما يلي:
اسمي أويفيند أساني، أنا نرويجي.