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

(PHP 5 >= 5.1.0, PHP 7)

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

الوصف

void __halt_compiler ( void )

توقف الدالة ()halt_compiler‎__ تنفيذ مترجم اللغة. قد يكون هذا مفيدًا لتضمين البيانات في برامج PHP، مثل ملفات التثبيت.

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

القيم المعادة

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

أمثلة

المثال 1: مثال على الدالة ()halt_compiler‎__

<?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.)

ملاحظة: يمكن استخدام الدالة ()halt_compiler‎__ بواسطة المجال الرئيسي للسكربت فقط (أي لا يمكن تنفيذها داخل دوال).

مصادر

• صفحة الدالة halt_compiler‎__ في توثيق PHP الرسمي.