PHP - Manual: sapi_windows_set_ctrl_handler
2024-11-14
(PHP 7 >= 7.4.0, PHP 8)
sapi_windows_set_ctrl_handler — Set or remove a CTRL event handler
Sets or removes a CTRL
event handler, which allows Windows
CLI processes to intercept or ignore CTRL+C
and
CTRL+BREAK
events. Note that in multithreaded environments,
this is only possible when called from the main thread.
handler
A callback function to set or remove. If set, this function will be called
whenever a CTRL+C
or CTRL+BREAK
event
occurs. The function is supposed to have the following signature:
$event
): voidevent
CTRL
event which has been received;
either PHP_WINDOWS_EVENT_CTRL_C
or PHP_WINDOWS_EVENT_CTRL_BREAK
.
null
handler
causes the process to ignore
CTRL+C
events, but not CTRL+BREAK
events.
add
If true
, the handler is set. If false
, the handler is removed.
成功时返回 true
, 或者在失败时返回 false
。
示例 #1 Basic sapi_windows_set_ctrl_handler() Usage
This example shows how to intercept CTRL
events.
<?php
function ctrl_handler(int $event)
{
switch ($event) {
case PHP_WINDOWS_EVENT_CTRL_C:
echo "You have pressed CTRL+C\n";
break;
case PHP_WINDOWS_EVENT_CTRL_BREAK:
echo "You have pressed CTRL+BREAK\n";
break;
}
}
sapi_windows_set_ctrl_handler('ctrl_handler');
while (true); // infinite loop, so the handler can be triggered
?>
官方地址:https://www.php.net/manual/en/function.sapi-windows-set-ctrl-handler.php