register_shutdown_function(3) [php man page]
REGISTER_SHUTDOWN_FUNCTION(3) 1 REGISTER_SHUTDOWN_FUNCTION(3) register_shutdown_function - Register a function for execution on shutdown SYNOPSIS
void register_shutdown_function (callable $callback, [mixed $parameter], [mixed $...]) DESCRIPTION
Registers a $callback to be executed after script execution finishes or exit(3) is called. Multiple calls to register_shutdown_function(3) can be made, and each will be called in the same order as they were registered. If you call exit(3) within one registered shutdown function, processing will stop completely and no other registered shutdown functions will be called. PARAMETERS
o $callback - The shutdown callback to register. The shutdown callbacks are executed as the part of the request, so it's possible to send output from them and access output buffers. o $parameter - It is possible to pass parameters to the shutdown function by passing additional parameters. o $... - RETURN VALUES
No value is returned. ERRORS
/EXCEPTIONS If the passed callback is not callable a E_WARNING level error will be generated. EXAMPLES
Example #1 register_shutdown_function(3) example <?php function shutdown() { // This is our shutdown function, in // here we can do any last operations // before the script is complete. echo 'Script executed with success', PHP_EOL; } register_shutdown_function('shutdown'); ?> NOTES
Note Working directory of the script can change inside the shutdown function under some web servers, e.g. Apache. Note Shutdown functions will not be executed if the process is killed with a SIGTERM or SIGKILL signal. While you cannot intercept a SIGKILL, you can use pcntl_signal(3) to install a handler for a SIGTERM which uses exit(3) to end cleanly. SEE ALSO
auto_append_file, exit(3), The section on connection handling. PHP Documentation Group REGISTER_SHUTDOWN_FUNCTION(3)
Check Out this Related Man Page
shutdown(8) System Manager's Manual shutdown(8) Name shutdown - close down the system at a given time Syntax /etc/shutdown [ -k ] [ -r ] [ -h ] [ -o ] time [ warning-message ... ] Description The command provides an automated shutdown procedure that a superuser can use to notify users when the system is shutting down. The time is the time at which will bring the system down. It may be the word `now', indicating an immediate shutdown, or specify a future time in one of two formats: + number or hour : min. The first form brings the system down in number minutes. The second brings the system down at the time of day indicated, using a 24-hour clock format. At intervals which get shorter as shutdown nears, warning messages are displayed at the terminals of all users on the system. Warning mes- sages are also sent to users who are logged in to a remote system that has mounted a file system or directory from the local system using NFS. Five minutes before shutdown, or immediately if shutdown is timed for less than five minutes, logins are disabled by creating and writing a message there. If this file exists when a user attempts to log in, prints its contents and exits. The file is removed just before exits. At shutdown time, a message is written in the file This message contains the time of shutdown, who ran shutdown, and the reason. Then, a terminate signal is sent at to bring the system to single-user state. If the or options are used, then executes or avoids shutting the system down (respectively). The option is for use by only. It indicates to that it is being called by and not to return to the user. You should place the time of the shutdown and the warning message in Use the message to inform the users about when the system will be back up and why it is going down. Restrictions You can kill the system only between now and 23:59, if you use the absolute time for shutdown. Files Tells login not to let anyone log in Log file for successful shutdowns See Also login(1), wall(1), halt(8), opser(8), reboot(8), rwalld(8c) shutdown(8)