Last updated: Fri, 05 Sep 2008

register_tick_function

(PHP 4 >= 4.0.3, PHP 5)

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

説明

bool register_tick_function ( callback $function [, mixed $arg [, mixed $... ]] )

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

パラメータ

function: 関数名を表す文字列、あるいはオブジェクトとメソッドを指定した配列。
arg
...

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

例

例1 register_tick_function() の例


<?php
// 関数をコールバックとして使用します
register_tick_function('my_function', true);

// オブジェクトのメソッドを使用します
$object = new my_class();
register_tick_function(array(&$object, 'my_method'), true);
?>

変更履歴

バージョン	説明
5.3.0	Ticks は非推奨となり、register_tick_function() は E_DEPRECATED をスローするようになりました。

注意

警告

register_tick_function() はスレッド化された Web サーバモジュールとともに使用することはできません。ZTS モードでは Tick は動作せず、Web サーバがクラッシュしてしまいます。

参考

add a note User Contributed Notes
register_tick_function

Jeremy
22-Jun-2007 03:03


I tried the following on an IIS 6/PHP 5 machine:



<?php

    

    set_time_limit(0);

    

    function profiler($return = false)

    {

        static $m = 0;

        if($return) return $m . " bytes";

        if(($mem = memory_get_usage()) > $m) $m = $mem;

    }

    

    register_tick_function('profiler');

    declare(ticks = 1);

    

    $numbers = array();

    for($i=0; $i<1000000; $i++)

    {

        print($i . "<br />");

    }

    

    print(profiler(true));

    

?>



...and got the following errors:



1) PHP has encountered an Unhandled Exception Code -1073741674 at 0435EC5A

2) PHP has encountered an Access Violation at 02727891

3) PHP has encountered an Access Violation at 02727879

4) PHP has encountered an Access Violation at 00000000



So far the code hasn't crashed the web server, but like the warning says, "register_tick_function() should not be used with threaded web server modules. Ticks are not working in ZTS mode and may crash your web server."



Strangely enough, the code does execute successfully every once in a while.

add a note

unregister_tick_function

register_shutdown_function

Last updated: Fri, 05 Sep 2008