عرض مصدر PHP/php check syntax

<noinclude>{{DISPLAYTITLE:الدالة <code>php_check_syntax()</code>‎ في PHP}}</noinclude>
(PHP 5 < 5.0.5)

تتحقق الدالة <code>php_check_syntax()</code>‎ من بنية PHP (وتنفذ) الملفَّ المحدد.

== الوصف ==
<syntaxhighlight lang="php">
bool php_check_syntax ( string $filename [, string &$error_message ] )
</syntaxhighlight>تُجري الدالةُ <code>php_check_syntax()‎</code> اختبارَ أدوات lint للتحليل على المعامل <code>filename</code> المحدد للبحث عن أخطاء برمجية.

يشبه هذا استخدام <code>php -l</code> من سطر الأوامر فيما عدا أن هذه الدالة ستنفذ (لكن لن تؤدي إلى إظهار مخرجات تنفيذ) المعامل <code>filename</code> المحدد.

مثلًا، إذا عُرَّفَتْ دالةٌ في الملف <code>filename</code>، فإن هذه الدالة المحددة ستكون متاحة للملف الذي نَفَّذّ الدالة <code>php_check_syntax()</code>‎، ولكن سيُمنَع الإخراج من المعامل <code>filename</code>.

ملاحظة: لأسباب تقنية، أُوقفت الدالة <code>php_check_syntax()‎</code> وأزيلت من PHP. استخدم بدلًا منها <code>php -l somefile.php</code> من سطر الأوامر.

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

=== <code>filename</code> ===
اسم الملف الذي سيُفحص.

=== <code>error_message</code> ===
إذا استُخدِمَ المعامل <code>error_message</code>، فسيحتوي على رسالة الخطأ تُنْشَأْ بواسطة مُدقِّق بناء الجُمَل. يُمَرَّرُ المعامل <code>error_message</code> بالمرجعية (passed by reference).

== القيم المعادة ==
تعيدُ الدالةُ <code>php_check_syntax()</code>‎ القيمة <code>TRUE</code> إذا اجتيز فحص أدوات lint للتحليل، والقيمة <code>FALSE</code> إذا فشل فحص أدوات lint أو إذا تعذر فتح الملف <code>filename</code>.

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|5.0.5
|أزيلت الدالةُ <code>php_check_syntax()‎</code> من PHP.
|-
|5.0.3
|استدعاء الدالة <code>[[PHP/exit|exit()]]</code>‎ بعد الدالة <code>php_check_syntax()</code>‎ يؤدي إلى <code>Segfault</code>.
|-
|5.0.1
|سيُمرَّر المعامل <code>error_message</code> بالمرجعية (passed by reference).
|}

== أمثلة ==
<syntaxhighlight lang="php">
php -l somefile.php
</syntaxhighlight>سينتجُ المثال السابق ما يشبه:<syntaxhighlight lang="php">
PHP Parse error: unexpected T_STRING in /tmp/somefile.php on line 81
</syntaxhighlight>

== انظر أيضًا ==
* عبارة <code>[[PHP/include|include]]</code>: تضمين ومعالجة الملف المحدّد.
* الدالة <code>[[PHP/is readable|is_readable()‎]]</code>: التحقق مما إذا كان الملف قابلًا للقراءة.

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