تحويل الأحرف المحددة مسبقًا "<" (أقل من) و">" (أكبر من) إلى كيانات HTML:
<?php $str = " هذا نص <b>غامق</b> . " ; htmlspecialchars ( $str ) ? >مخرجات HTML للكود أعلاه هي كما يلي (عرض الكود المصدري):
< ! أتش تي أم أل > <أتش تي أم أل> < body > هذا هو النص & lt ; & gt ; </html>مخرجات المتصفح للكود أعلاه هي كما يلي:
هذا نص <b>غامق</b>.تقوم الدالة htmlspecialchars() بتحويل بعض الأحرف المحددة مسبقًا إلى كيانات HTML.
الأحرف المحددة مسبقًا هي:
& (علامة الضم) تصبح &
"(علامة الاقتباس المزدوجة) تصبح "
"(اقتباس مفرد) يصبح"
< (أقل من) يصبح <؛
> (أكبر من) تصبح>
نصيحة: لتحويل كيانات HTML الخاصة إلى أحرف مرة أخرى، استخدم الدالة htmlspecialchars_decode().
htmlspecialchars ( سلسلة، أعلام، مجموعة أحرف، ترميز مزدوج )
| المعلمة | يصف |
|---|---|
| خيط | مطلوب. يحدد السلسلة المراد تحويلها. |
| أعلام | خياري. يحدد كيفية التعامل مع علامات الاقتباس والترميزات غير الصالحة ونوع المستند الذي سيتم استخدامه. أنواع الاقتباس المتاحة: 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 = " جين و 'طرزان ' " ; htmlspecialchars ( $str , ENT_COMPAT ) ; // افتراضي، يتم ترميز علامات الاقتباس المزدوجة فقط صدى " <br> " ; htmlspecialchars ( $str , ENT_QUOTES ) ; // تشفير علامات الاقتباس المزدوجة وعلامات الاقتباس المفردة صدى " <br> " ; htmlspecialchars ( $str , ENT_NOQUOTES ) ; // لا تقم بتشفير أي علامات اقتباس ?>مخرجات HTML للكود أعلاه هي كما يلي (عرض الكود المصدري):
< ! أتش تي أم أل > <أتش تي أم أل> < الجسم > جين و ' طرزان ' < br > جين و ' طرزان ' < br > جين و ' طرزان ' </ الجسم > </html>مخرجات المتصفح للكود أعلاه هي كما يلي:
جين و"طرزان"جين و"طرزان"جين و"طرزان"تحويل علامات الاقتباس المزدوجة إلى كيانات HTML:
<?php $str = ' أحب "PHP " ; htmlspecialchars ( $str , ENT_QUOTES ) ; // تشفير علامات الاقتباس المزدوجة وعلامات الاقتباس المفردة ?> ;مخرجات HTML للكود أعلاه هي كما يلي (عرض الكود المصدري):
< ! أتش تي أم أل > <أتش تي أم أل> < الجسم > أحب & quot ; </html>مخرجات المتصفح للكود أعلاه هي كما يلي:
أنا أحب "PHP".