Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

register_shutdown_function(3) [php man page]


register_shutdown_function - Register a function for execution on shutdown

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)

       shutdown - close down the system at a given time

       /etc/shutdown [ -k ] [ -r ] [ -h ] [ -o ] time [ warning-message ... ]

       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.

       You can kill the system only between now and 23:59, if you use the absolute time for shutdown.

       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)


Featured Tech Videos