الدالة ()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 الرسمي.