الدالة register_shutdown_function() في PHP
(PHP 4, PHP 5, PHP 7)
تُسجل الدالة register_shutdown_function() دالة لتُنفّذ عند إنهاء التشغيل.
الوصف
void register_shutdown_function ( callable $callback [, mixed $parameter [, mixed $... ]] )
تُسجل الدالة register_shutdown_function() دالة رد النداء ليتم تنفيذها بعد الانتهاء من تنفيذ السكربت أو بعد استدعاء الدالة exit().
من الممكن إجراء استدعاءات متعددة للدالة register_shutdown_function()، وستُستدعى كلٌ منها بالترتيب الذي سُجِّلَت به. فإذا استدعيت الدالة exit() داخل دالة إيقاف تشغيل مُسجلة، فستتوقف المعالجة بالكامل ولن تُستدعى أية دالة إيقاف تشغيل أخرى مسجّلة.
المعاملات
callback
لتسجيل دالة رد النداء التي ستُنفذ عند إنهاء التشغيل.
تُنفّذ دالة رد نداء إنهاء التشغيل كجزء من الطلب، لذلك فمن الممكن إرسال خرجها والوصول إلى مخازن الخرج الموقتة (output buffers).
parameter
من الممكن تمرير المعاملات إلى دالة إيقاف التشغيل من خلال تمرير معاملات إضافية.
...
بقية المعاملات.
القيم المعادة
لا توجد قيم معادة.
الأخطاء والاستثناءات
إذا كانت دالة رد النداء الممرّرة غير قابلة للاستدعاء، فسيُولّد خطأ ذو المستوى E_WARNING.
أمثلة
المثال 1: مثال عن استخدام الدالة register_shutdown_function()
<?php
function shutdown()
{
// هذه دالة إيقاف التشغيل
// داخلها نستطيع القيام بأية عمليات أخيرة
// قبل اتمام السكربت
echo 'Script executed with success', PHP_EOL;
}
register_shutdown_function('shutdown');
?>
ملاحظات
من الممكن تغيير مجلد العمل الحالي في دالة إنهاء التشغيل في بعض خوادم الويب، مثل أباتشي.
لن تُنفَّذ دوال إيقاف التشغيل إذا أُنهيت العملية بإشارة SIGTERM أو SIGKILL. صحيحٌ أننا لا نستطيع اعتراض SIGKILL، لكن يمكننا استخدام الدالة pcntl_signal() لمعالجة الإشارة SIGTERM الذي يستخدم الدالة exit() لإنهاء السكربت بشكل سليم.
انظر أيضًا
- الدالة
exit(): إخراج رسالة و إنهاء السكربت الحالي.