(PHP 7 >= 7.4.0, PHP 8)
sapi_windows_set_ctrl_handler — Define ou remove um manipulador de evento CTRL
Define ou remove um manipulador de evento CTRL
, que permite que os processos
CLI do Windows interceptem ou ignorem eventos CTRL+C
e
CTRL+BREAK
. Observe que em ambientes multi-thread,
isto só é possível quando a função é chamada da thread principal.
handler
Uma função de chamada de retorno a ser definida ou removida. Se definida, esta função será chamada sempre que um evento CTRL +C ou CTRL +BREAK ocorrer. A função deve ter a seguinte assinatura:
event
PHP_WINDOWS_EVENT_CTRL_C
ou PHP_WINDOWS_EVENT_CTRL_BREAK
.
handler
como null
faz com que o processo ignore eventos
CTRL
+C
,
mas não os eventos
CTRL
+BREAK
.
add
Se for igual a true
, o manipulador é definido. Se for false
, o manipulador é removido.
Exemplo #1 Uso Básico de sapi_windows_set_ctrl_handler()
Este exemplo mostra como interceptar eventos CTRL
.
<?php
function ctrl_handler(int $event)
{
switch ($event) {
case PHP_WINDOWS_EVENT_CTRL_C:
echo "CTRL+C foi pressionado\n";
break;
case PHP_WINDOWS_EVENT_CTRL_BREAK:
echo "CTRL+BREAK foi pressionado\n";
break;
}
}
sapi_windows_set_ctrl_handler('ctrl_handler');
while (true); // repetição infinita, para que o manipulador seja disparado
?>