عرض مصدر PHP/halt compiler

= الدالة ()halt_compiler‎__ في PHP =
توقف الدالة ()halt_compiler‎__  تنفيذ مترجم اللغة.

== الوصف ==
<syntaxhighlight lang="php">
void __halt_compiler ( void )
</syntaxhighlight>توقف الدالة ()halt_compiler‎__ تنفيذ مترجم اللغة. قد يكون هذا مفيدًا لتضمين البيانات في برامج PHP، مثل ملفات التثبيت.

يمكن تحديد موضع البايت لبداية البيانات بواسطة الثابت __COMPILER_HALT_OFFSET__ الذي يُعَرَّف فقط إذا كانت الدالة ()halt_compiler‎__  مستعملةً في الملف.

== القيم المعادة ==
لا تعيد الدالة ()halt_compiler‎__ قيمًا.

== أمثلة ==
المثال 1: مثال على الدالة ()halt_compiler‎__<syntaxhighlight lang="php">
<?php

// فتح الملف

$fp = fopen(__FILE__, 'r');

// نقل مؤشر القراءة إلى مكان بدء البيانات المُضمَّنة

fseek($fp, __COMPILER_HALT_OFFSET__);

// وإخراجها

var_dump(stream_get_contents($fp));

// نهاية تنفيذ البرنامج

__halt_compiler(); the installation data (eg. tar, gz, PHP, etc.)
</syntaxhighlight>ملاحظة: يمكن استخدام الدالة ()halt_compiler‎__ بواسطة المجال الرئيسي للسكربت فقط (أي لا يمكن تنفيذها داخل دوال).

== مصادر ==
* [http://php.net/manual/en/function.halt-compiler.php صفحة الدالة halt_compiler‎__ في توثيق PHP الرسمي.]