عرض مصدر PHP/register shutdown function

(PHP 4, PHP 5, PHP 7)

تُسجل الدالة <code>register_shutdown_function()‎</code> دالة لتُنفّذ عند إنهاء التشغيل.

== الوصف ==
----<syntaxhighlight lang="php">
 void register_shutdown_function ( callable $callback [, mixed $parameter [,  mixed $... ]] )
</syntaxhighlight>تُسجل الدالة <code>register_shutdown_function()‎</code> دالة [[PHP/callable|رد النداء]] ليتم تنفيذها بعد الانتهاء من تنفيذ السكربت أو بعد استدعاء الدالة <code>[[PHP/exit|exit()‎]]</code>.

من الممكن إجراء استدعاءات متعددة للدالة <code>register_shutdown_function()‎</code>، وستُستدعى كلٌ منها بالترتيب الذي سُجِّلَت به. فإذا استدعيت الدالة <code>[[PHP/exit|exit()‎]]</code> داخل دالة إيقاف تشغيل مُسجلة، فستتوقف المعالجة بالكامل ولن تُستدعى أية دالة إيقاف تشغيل أخرى مسجّلة.

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

=== <code>callback</code> ===
لتسجيل دالة رد النداء التي ستُنفذ عند إنهاء التشغيل.

تُنفّذ دالة رد نداء إنهاء التشغيل كجزء من الطلب، لذلك فمن الممكن إرسال خرجها والوصول إلى مخازن الخرج الموقتة (output buffers).

=== <code>parameter</code> ===
من الممكن تمرير المعاملات إلى دالة إيقاف التشغيل من خلال تمرير معاملات إضافية.

<code>...</code>

بقية المعاملات.

== القيم المعادة ==
----لا توجد قيم معادة

== الأخطاء والاستثناءات ==
----إذا كانت [[PHP/callable|دالة رد النداء]] الممرّرة غير قابلة للاستدعاء، فسيُولّد خطأ ذو المستوى <code>E_WARNING</code>.

== أمثلة ==
المثال 1: مثال عن استخدام الدالة <code>register_shutdown_function()‎</code><syntaxhighlight lang="php">
<?php
function shutdown()
{
    // هذه دالة إيقاف التشغيل 
    // داخلها نستطيع القيام بأية عمليات أخيرة
    // قبل اتمام السكربت


    echo 'Script executed with success', PHP_EOL;
}

register_shutdown_function('shutdown');
?>
</syntaxhighlight>

== ملاحظات ==
----من الممكن تغيير مجلد العمل الحالي في دالة إنهاء التشغيل في بعض خوادم الويب، مثل أباتشي.

لن تُنفَّذ دوال إيقاف التشغيل إذا أُنهيت العملية بإشارة <code>SIGTERM</code> أو <code>SIGKILL</code>. صحيحٌ أننا لا نستطيع اعتراض <code>SIGKILL</code>، لكن يمكننا استخدام الدالة <code>[[PHP/pcntl signal|pcntl_signal()‎]]</code> لمعالجة الإشارة <code>SIGTERM</code> الذي يستخدم الدالة <code>[[PHP/exit|exit()‎]]</code> لإنهاء السكربت بشكل سليم.

== انظر أيضًا ==
----
* الدالة <code>[[PHP/exit|exit()‎]]</code>: إخراج رسالة و إنهاء السكربت الحالي.

== مصادر ==
----
* [http://php.net/manual/en/function.register-shutdown-function.php صفحة الدالة register_shutdown_function في توثيق PHP الرسمي.]