الدالة highlight_file() في PHP
(PHP 4, PHP 5, PHP 7)
تلوّن الدالةُ highlight_file() شيفرات PHP في مَلفّ.
الوصف
mixed highlight_file ( string $filename [, bool $return = FALSE ] )
تخرجُ أو تعيدُ الدالّة highlight_file() الملف المشار إليه في المعامل filename مع تلوين شيفرات PHP.
تُهَيَّأ العديد من خوادم أباتشي لتلوين شيفرات PHP في الملفات ذات الامتداد phps. تلقائيًا. فمثلًا، سَيُظْهِرُ الملف example.phps عند عرضه شيفراتَ PHP الملونة في الملف. للسماح بهذا، أضف هذا السطر إلى ملف الضبط httpd.conf:
AddType application/x-httpd-php-source .phps
المعاملات
filename
المسار إلى ملف PHP لِتلوين شيفرات PHP فيه.
return
ضبط المعامل return إلى القيمة TRUE سيجعل الدالة highlight_file() تعيد الشيفرة الملونة (ولن تطبعها مباشرةً).
القيم المعادة
إذا ضُبط المعامل return إلى القيمة TRUE، فَسَتُعاد الشيفرة الملونة كسلسلة نصية بدلًا من طباعتها. وإلا، فستعاد القيمة TRUE عند النجاح، والقيمة FALSE عند الفشل.
سجل التغييرات
| الإصدار | الوصف |
|---|---|
| 4.2.1 | تتأثر الدالةُ highlight_file() الآن أيضًا بخياري الضبط safe_mode و open_basedir.
|
ملاحظات
تحذير: يجب توخي الحذر عند استخدام الدالة highlight_file() للتأكد من عدم الكشف عن معلومات حساسة عن غير قصد مثل كلمات المرور أو أي نوع آخر من المعلومات التي قد تؤدي إلى مخاطر أمنية محتملة.
ملاحظة: عند استخدام المعامل return، تَستخدِمُ الدالةُ highlight_file() التخزينَ المؤقت للإخراج الداخلي بحيث لا يمكن استخدامها داخل دالة رد النداء ob_start().
انظر أيضًا
- الدالة
highlight_string(): تلوين شيفرات PHP في سلسلة نصية.