(PHP 7 >= 7.4.0, PHP 8)
sapi_windows_set_ctrl_handler — CTRLイベント のハンドラを設定したり削除したりする
CTRL イベントのハンドラを設定したり削除したりします。
これによって、Windows の CLI プロセスが、
CTRL
+C
や
CTRL
+BREAK
イベントに割り込んだり、無視したり出来るようになります。
マルチスレッド環境では、この操作はメインスレッドからのみ可能です。
handler設定したり削除したりするコールバック関数。 設定した場合、この関数は CTRL +C や CTRL +BREAK イベントが発生した場合にいつでも呼び出されます。 関数のシグネチャは次のとおりです:
eventPHP_WINDOWS_EVENT_CTRL_C
または PHP_WINDOWS_EVENT_CTRL_BREAK
null を handler に設定すると、
CTRL
+C
イベント をプロセスに無視させますが、
CTRL
+BREAK
イベントは無視しません。
add例1 基本的な sapi_windows_set_ctrl_handler() 関数の使い方
以下の例は、 CTRLイベント にどのように割り込むかを示しています。
<?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); // ハンドラがトリガできるように無限ループにする
?>