الفرق بين المراجعتين لصفحة: «PHP/highlight file»
رؤيا-بنعطية (نقاش | مساهمات) لا ملخص تعديل |
رؤيا-بنعطية (نقاش | مساهمات) إضافات و تعديلات تنسيقية |
||
| سطر 2: | سطر 2: | ||
(PHP 4, PHP 5, PHP 7) | (PHP 4, PHP 5, PHP 7) | ||
تلوّن الدالةُ highlight_file() شيفرات PHP في مَلفّ. | تلوّن الدالةُ <code>highlight_file()</code> شيفرات PHP في مَلفّ. | ||
== الوصف == | == الوصف == | ||
| سطر 9: | سطر 9: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
تخرجُ أو تعيدُ الدالّة highlight_file() الملف المشار إليه في المعامل filename مع تلوين شيفرات PHP. | تخرجُ أو تعيدُ الدالّة <code>highlight_file()</code> الملف المشار إليه في المعامل <code>filename</code> مع تلوين شيفرات PHP. | ||
تُهَيَّأ العديد من خوادم أباتشي لتلوين شيفرات PHP في الملفات ذات الامتداد phps. تلقائيًا. فمثلًا، سَيُظْهِرُ الملف example.phps عند عرضه شيفراتَ PHP الملونة في الملف. للسماح بهذا، أضف هذا السطر إلى ملف الضبط httpd.conf:<syntaxhighlight lang="php"> | تُهَيَّأ العديد من خوادم أباتشي لتلوين شيفرات PHP في الملفات ذات الامتداد phps. تلقائيًا. فمثلًا، سَيُظْهِرُ الملف example.phps عند عرضه شيفراتَ PHP الملونة في الملف. للسماح بهذا، أضف هذا السطر إلى ملف الضبط httpd.conf:<syntaxhighlight lang="php"> | ||
| سطر 17: | سطر 17: | ||
== المعاملات == | == المعاملات == | ||
=== filename === | === <code>filename</code> === | ||
المسار إلى ملف PHP لِتلوين شيفرات PHP فيه. | المسار إلى ملف PHP لِتلوين شيفرات PHP فيه. | ||
=== return === | === <code>return</code> === | ||
ضبط المعامل return إلى القيمة TRUE سيجعل الدالة highlight_file() تعيد الشيفرة الملونة (ولن تطبعها مباشرةً). | ضبط المعامل <code>return</code> إلى القيمة <code>TRUE</code> سيجعل الدالة <code>highlight_file()</code> تعيد الشيفرة الملونة (ولن تطبعها مباشرةً). | ||
== القيم المعادة == | == القيم المعادة == | ||
إذا ضُبط المعامل return إلى القيمة | إذا ضُبط المعامل <code>return</code> إلى القيمة <code>TRUE</code>، فَسَتُعاد الشيفرة الملونة كسلسلة نصية بدلًا من طباعتها. وإلا، فستعاد القيمة <code>TRUE</code> عند النجاح، والقيمة <code>FALSE</code> عند الفشل. | ||
== سجل التغييرات == | == سجل التغييرات == | ||
| سطر 32: | سطر 32: | ||
|- | |- | ||
|4.2.1 | |4.2.1 | ||
|تتأثر الدالةُ highlight_file() الآن أيضًا بخياري الضبط safe_mode و open_basedir. | |تتأثر الدالةُ <code>highlight_file()</code> الآن أيضًا بخياري الضبط safe_mode و open_basedir. | ||
|} | |} | ||
== ملاحظات == | == ملاحظات == | ||
تحذير: يجب توخي الحذر عند استخدام الدالة highlight_file() للتأكد من عدم الكشف عن معلومات حساسة عن غير قصد مثل كلمات المرور أو أي نوع آخر من المعلومات التي قد تؤدي إلى مخاطر أمنية محتملة. | تحذير: يجب توخي الحذر عند استخدام الدالة <code>highlight_file()</code> للتأكد من عدم الكشف عن معلومات حساسة عن غير قصد مثل كلمات المرور أو أي نوع آخر من المعلومات التي قد تؤدي إلى مخاطر أمنية محتملة. | ||
ملاحظة: عند استخدام المعامل | ملاحظة: عند استخدام المعامل <code>return</code>، تَستخدِمُ الدالةُ <code>highlight_file()</code> التخزينَ المؤقت للإخراج الداخلي بحيث لا يمكن استخدامها داخل دالة رد النداء <code>ob_start()</code>. | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* الدالة highlight_string(): تلوين شيفرات PHP في سلسلة نصية. | * الدالة <code>[[PHP/highlight string|highlight_string()]]</code>: تلوين شيفرات PHP في سلسلة نصية. | ||
== مصادر == | == مصادر == | ||
مراجعة 23:47، 26 مايو 2018
(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 في سلسلة نصية.