【PHP8.x】hrtime関数の使い方

<?php

/**
 * 高精度タイマー(hrtime)を使用して処理時間を計測し、ミリ秒で出力します。
 *
 * この関数は、特定の処理の実行にかかった時間をナノ秒単位で計測し、
 * それを人間が読みやすいミリ秒単位に変換して表示します。
 */
function demonstrateHrtimeToMilliseconds(): void
{
    // 処理開始前の高精度タイムスタンプをナノ秒単位の数値として取得します。
    // hrtime(true) は、システム起動時からの経過時間をナノ秒で返します。
    $startTime = hrtime(true);

    // ここに時間を計測したい処理を記述します。
    // この例では、100ミリ秒 (100,000マイクロ秒) の待機処理をシミュレートします。
    usleep(100000);

    // 処理終了後の高精度タイムスタンプを取得します。
    $endTime = hrtime(true);

    // 終了時刻から開始時刻を引いて、経過時間をナノ秒で計算します。
    $elapsedTimeNanoseconds = $endTime - $startTime;

    // 経過時間（ナノ秒）をミリ秒に変換します。
    // 1ミリ秒 = 1,000,000ナノ秒 です。
    $elapsedTimeMilliseconds = $elapsedTimeNanoseconds / 1_000_000;

    // 計測結果を小数点以下3桁まで表示します。
    echo sprintf("経過時間: %.3f ミリ秒\n", $elapsedTimeMilliseconds);
}

// 関数を実行して結果を表示します。
demonstrateHrtimeToMilliseconds();

PHPのhrtime()関数は、システムの任意の時点からの経過時間を高精度なナノ秒単位で取得します。主に、特定の処理にかかった時間を正確に計測する目的で使用されます。

この関数は、引数に true を渡すと、戻り値として経過時間をナノ秒単位の数値（整数または浮動小数点数）で返します。引数を指定しない、または false を渡した場合は、秒とナノ秒を要素に持つ配列が返されます。

サンプルコードは、この関数を使って処理時間をミリ秒で計測する例です。まず、処理開始前に hrtime(true) を呼び出して開始時刻を数値として取得します。次に対象の処理を実行し、その直後に再び hrtime(true) で終了時刻を取得します。そして、終了時刻から開始時刻を引くことで、処理に要した時間をナノ秒単位で算出します。最後に、この結果はナノ秒であるため、1,000,000で割ることで人間が理解しやすいミリ秒単位に変換し、画面に出力しています。