Extension uses C signal function (from <signal.h>) to call previously defined callback, if appropriate signal has arrived (i.e SIGUSR1).
Could be used with php-amqp to print the actual worker/consumer status (ie. message stats, last operation performed etc.)
What's more it is possible to "catch" a unix signal i.e. SIGTERM and then kill the process nicely (program won't stop untill all operations are completed). It is very useful if script operates on sensitive data which cannot be damaged.
If a blocking method (such as AMQPQueue::consume() from php-amqp) is holding the processing thread, then you won't be able to call pcntl_signal_dispatch() and trigger the callbacks registered with pcntl_signal().
Extension will work only if C function signal is available (only on UNIX systems).
PHP versions supported:
- PHP 8
- PHP 7
<?php
function getInfo($noStatus){
echo "getInfo called with status $noStatus\n";
}
$r = attach_signal(10, 'getInfo');
while(true){}
?>Spawn the process:
php your_script_name.php
Kill the first process from the list:
kill -s SIGUSR1 `ps -ef | grep php | head -n1 | awk '{print $2}'`
After that steps you should see:
getInfo called with status 10