الفرق بين المراجعتين لصفحة: «PHP/php check syntax»
< PHP
رؤيا-بنعطية (نقاش | مساهمات) لا ملخص تعديل |
رؤيا-بنعطية (نقاش | مساهمات) إضافات و تعديلات تنسيقية |
||
| سطر 2: | سطر 2: | ||
(PHP 5 < 5.0.5) | (PHP 5 < 5.0.5) | ||
تتحقق الدالة php_check_syntax() من بنية PHP (وتنفذ) الملفَّ المحدد. | تتحقق الدالة <code>php_check_syntax()</code> من بنية PHP (وتنفذ) الملفَّ المحدد. | ||
== الوصف == | == الوصف == | ||
<syntaxhighlight lang="php"> | <syntaxhighlight lang="php"> | ||
bool php_check_syntax ( string $filename [, string &$error_message ] ) | bool php_check_syntax ( string $filename [, string &$error_message ] ) | ||
</syntaxhighlight>تُجري الدالةُ php_check_syntax() اختبارَ أدوات lint للتحليل على المعامل filename المحدد للبحث عن أخطاء برمجية. | </syntaxhighlight>تُجري الدالةُ <code>php_check_syntax()</code> اختبارَ أدوات lint للتحليل على المعامل <code>filename</code> المحدد للبحث عن أخطاء برمجية. | ||
يشبه هذا استخدام php -l من سطر الأوامر فيما عدا أن هذه الدالة ستنفذ (لكن لن تؤدي إلى إظهار مخرجات تنفيذ) المعامل filename المحدد. | يشبه هذا استخدام <code>php -l</code> من سطر الأوامر فيما عدا أن هذه الدالة ستنفذ (لكن لن تؤدي إلى إظهار مخرجات تنفيذ) المعامل <code>filename</code> المحدد. | ||
مثلًا، إذا عُرَّفَتْ دالةٌ في الملف | مثلًا، إذا عُرَّفَتْ دالةٌ في الملف <code>filename</code>، فإن هذه الدالة المحددة ستكون متاحة للملف الذي نَفَّذّ الدالة <code>php_check_syntax()</code>، ولكن سيُمنَع الإخراج من المعامل <code>filename</code>. | ||
ملاحظة: لأسباب تقنية، أُوقفت الدالة php_check_syntax() وأزيلت من PHP. استخدم بدلًا منها php -l somefile.php من سطر الأوامر. | ملاحظة: لأسباب تقنية، أُوقفت الدالة <code>php_check_syntax()</code> وأزيلت من PHP. استخدم بدلًا منها <code>php -l somefile.php</code> من سطر الأوامر. | ||
== المعاملات == | == المعاملات == | ||
=== filename === | === <code>filename</code> === | ||
اسم الملف الذي سيُفحص. | اسم الملف الذي سيُفحص. | ||
=== error_message === | === <code>error_message</code> === | ||
إذا استُخدِمَ المعامل | إذا استُخدِمَ المعامل <code>error_message</code>، فسيحتوي على رسالة الخطأ تُنْشَأْ بواسطة مُدقِّق بناء الجُمَل. يُمَرَّرُ المعامل <code>error_message</code> بالمرجعية (passed by reference). | ||
== القيم المعادة == | == القيم المعادة == | ||
تعيدُ الدالةُ php_check_syntax() القيمة TRUE إذا اجتيز فحص أدوات lint للتحليل، والقيمة FALSE إذا فشل فحص أدوات lint أو إذا تعذر فتح الملف filename. | تعيدُ الدالةُ <code>php_check_syntax()</code> القيمة <code>TRUE</code> إذا اجتيز فحص أدوات lint للتحليل، والقيمة <code>FALSE</code> إذا فشل فحص أدوات lint أو إذا تعذر فتح الملف <code>filename</code>. | ||
== سجل التغييرات == | == سجل التغييرات == | ||
| سطر 32: | سطر 32: | ||
|- | |- | ||
|5.0.5 | |5.0.5 | ||
|أزيلت الدالةُ php_check_syntax() من PHP. | |أزيلت الدالةُ <code>php_check_syntax()</code> من PHP. | ||
|- | |- | ||
|5.0.3 | |5.0.3 | ||
|استدعاء الدالة exit() بعد الدالة php_check_syntax() يؤدي إلى Segfault. | |استدعاء الدالة <code>exit()</code> بعد الدالة <code>php_check_syntax()</code> يؤدي إلى <code>Segfault</code>. | ||
|- | |- | ||
|5.0.1 | |5.0.1 | ||
|سيُمرَّر المعامل error_message بالمرجعية (passed by reference). | |سيُمرَّر المعامل <code>error_message</code> بالمرجعية (passed by reference). | ||
|} | |} | ||
| سطر 49: | سطر 49: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* عبارة include: تضمين ومعالجة الملف المحدّد. | * عبارة <code>[[PHP/include|include]]</code>: تضمين ومعالجة الملف المحدّد. | ||
* الدالة is_readable(): التحقق مما إذا كان الملف قابلًا للقراءة. | * الدالة <code>[[PHP/is readable|is_readable()]]</code>: التحقق مما إذا كان الملف قابلًا للقراءة. | ||
== مصادر == | == مصادر == | ||
مراجعة 23:31، 26 مايو 2018
(PHP 5 < 5.0.5)
تتحقق الدالة php_check_syntax() من بنية PHP (وتنفذ) الملفَّ المحدد.
الوصف
bool php_check_syntax ( string $filename [, string &$error_message ] )
تُجري الدالةُ php_check_syntax() اختبارَ أدوات lint للتحليل على المعامل filename المحدد للبحث عن أخطاء برمجية.
يشبه هذا استخدام php -l من سطر الأوامر فيما عدا أن هذه الدالة ستنفذ (لكن لن تؤدي إلى إظهار مخرجات تنفيذ) المعامل filename المحدد.
مثلًا، إذا عُرَّفَتْ دالةٌ في الملف filename، فإن هذه الدالة المحددة ستكون متاحة للملف الذي نَفَّذّ الدالة php_check_syntax()، ولكن سيُمنَع الإخراج من المعامل filename.
ملاحظة: لأسباب تقنية، أُوقفت الدالة php_check_syntax() وأزيلت من PHP. استخدم بدلًا منها php -l somefile.php من سطر الأوامر.
المعاملات
filename
اسم الملف الذي سيُفحص.
error_message
إذا استُخدِمَ المعامل error_message، فسيحتوي على رسالة الخطأ تُنْشَأْ بواسطة مُدقِّق بناء الجُمَل. يُمَرَّرُ المعامل error_message بالمرجعية (passed by reference).
القيم المعادة
تعيدُ الدالةُ php_check_syntax() القيمة TRUE إذا اجتيز فحص أدوات lint للتحليل، والقيمة FALSE إذا فشل فحص أدوات lint أو إذا تعذر فتح الملف filename.
سجل التغييرات
| الإصدار | الوصف |
| 5.0.5 | أزيلت الدالةُ php_check_syntax() من PHP.
|
| 5.0.3 | استدعاء الدالة exit() بعد الدالة php_check_syntax() يؤدي إلى Segfault.
|
| 5.0.1 | سيُمرَّر المعامل error_message بالمرجعية (passed by reference).
|
أمثلة
php -l somefile.php
سينتجُ المثال السابق ما يشبه:
PHP Parse error: unexpected T_STRING in /tmp/somefile.php on line 81
انظر أيضًا
- عبارة
include: تضمين ومعالجة الملف المحدّد. - الدالة
is_readable(): التحقق مما إذا كان الملف قابلًا للقراءة.