الدالة php_check_syntax()‎ في PHP

من موسوعة حسوب
< 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()‎: التحقق مما إذا كان الملف قابلًا للقراءة.

مصادر