array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.sapi-windows-set-ctrl-handler.php', 1 => 'sapi_windows_set_ctrl_handler', ), 'up' => array ( 0 => 'ref.misc.php', 1 => 'Misc. Funções', ), 'prev' => array ( 0 => 'function.sapi-windows-generate-ctrl-event.php', 1 => 'sapi_windows_generate_ctrl_event', ), 'next' => array ( 0 => 'function.sapi-windows-vt100-support.php', 1 => 'sapi_windows_vt100_support', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/misc/functions/sapi-windows-set-ctrl-handler.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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
CTRL
que foi recebido;
pode ser 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
?>