الدالة php_check_syntax()
في PHP
(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()
: التحقق مما إذا كان الملف قابلًا للقراءة.