register_tick_function

(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)

register_tick_function — 各 tick で実行する関数を登録する

説明

function register_tick_function(callable $callback, mixed ...$args): bool

tick がコールされた際に実行される callback という名前の関数を登録します。

パラメータ

callback: 登録する関数
args

戻り値

成功した場合に true を、失敗した場合に false を返します。

変更履歴

バージョン	説明
8.5.0	tick ハンドラが無効化されるタイミングが、リクエストのシャットダウン処理のより後の段階に移りました。すべてのシャットダウン関数とデストラクタが実行され、出力ハンドラがクリーンアップされた後に無効化されます。これより前のバージョンでは、リクエストのシャットダウン処理の一番最初に無効化されていたため、シャットダウン関数やデストラクタ、出力処理の中では tick 関数がコールされませんでした。詳細は移行ガイドを参照ください。

バージョン

説明

8.5.0

tick ハンドラが無効化されるタイミングが、リクエストのシャットダウン処理のより後の段階に移りました。すべてのシャットダウン関数とデストラクタが実行され、出力ハンドラがクリーンアップされた後に無効化されます。これより前のバージョンでは、リクエストのシャットダウン処理の一番最初に無効化されていたため、シャットダウン関数やデストラクタ、出力処理の中では tick 関数がコールされませんでした。詳細は移行ガイドを参照ください。

例

例1 register_tick_function() の例

<?php
declare(ticks=1);

function my_tick_function($param) {
    echo "Tick callback function called with param: $param\n";
}

register_tick_function('my_tick_function', true);
?>

参考

declare
unregister_tick_function() - 各 tick の実行用の関数の登録を解除する

関連キーワード:

tick 登録 register callback シャットダウン無効化 param unregister args ハンドラリクエストデストラクタ declare shutdown callable mixed 成功履歴タイミング段階アップ一番最初詳細移行