عرض مصدر PHP/highlight file

<noinclude>{{DISPLAYTITLE:الدالة <code>highlight_file()</code>‎ في PHP}}</noinclude>
(PHP 4, PHP 5, PHP 7)

تلوّن الدالةُ <code>highlight_file()‎</code> شيفرات PHP في مَلفّ.

== الوصف ==
<syntaxhighlight lang="php">
mixed highlight_file ( string $filename [, bool $return = FALSE ] )
</syntaxhighlight>

تخرجُ أو تعيدُ الدالّة <code>highlight_file()‎</code> الملف المشار إليه في المعامل <code>filename</code> مع تلوين شيفرات PHP.

تُهَيَّأ العديد من خوادم أباتشي لتلوين شيفرات PHP في الملفات ذات الامتداد phps. تلقائيًا. فمثلًا، سَيُظْهِرُ الملف example.phps عند عرضه شيفراتَ PHP الملونة في الملف. للسماح بهذا، أضف هذا السطر إلى ملف الضبط httpd.conf:<syntaxhighlight lang="php">
AddType application/x-httpd-php-source .phps
</syntaxhighlight>

== المعاملات ==

=== <code>filename</code> ===
المسار إلى ملف PHP لِتلوين شيفرات PHP فيه.

=== <code>return</code> ===
ضبط المعامل <code>return</code> إلى القيمة <code>TRUE</code> سيجعل الدالة <code>highlight_file()</code>‎ تعيد الشيفرة الملونة (ولن تطبعها مباشرةً).

== القيم المعادة ==
إذا ضُبط المعامل <code>return</code> إلى القيمة <code>TRUE</code>،  فَسَتُعاد الشيفرة الملونة كسلسلة نصية بدلًا من طباعتها. وإلا، فستعاد القيمة <code>TRUE</code> عند النجاح، والقيمة <code>FALSE</code> عند الفشل.

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|4.2.1
|تتأثر الدالةُ <code>highlight_file()‎</code> الآن أيضًا بخياري الضبط safe_mode و open_basedir.
|}

== ملاحظات ==
تحذير: يجب توخي الحذر عند استخدام الدالة <code>highlight_file()‎</code> للتأكد من عدم الكشف عن معلومات حساسة عن غير قصد مثل كلمات المرور أو أي نوع آخر من المعلومات التي قد تؤدي إلى مخاطر أمنية محتملة.

ملاحظة: عند استخدام المعامل <code>return</code>، تَستخدِمُ الدالةُ <code>highlight_file()‎</code> التخزينَ المؤقت للإخراج الداخلي بحيث لا يمكن استخدامها داخل دالة رد النداء <code>[[PHP/ob start|ob_start()]]</code>‎.

== انظر أيضًا ==
* الدالة <code>[[PHP/highlight string|highlight_string()‎]]</code>: تلوين شيفرات PHP في سلسلة نصية.

== مصادر ==
* [http://php.net/manual/en/function.highlight-file.php صفحة الدالة highlight_file‎ في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP Miscellaneous]]