【PHP8.x】lcg_value()関数の使い方

Copy
1<?php
2
3/**
4 * PHPの lcg_value() 関数を使用して、擬似乱数を生成するサンプルコード。
5 *
6 * lcg_value() 関数は、線形合同法 (Linear Congruential Generator) に基づき、
7 * 0.0 以上 1.0 未満の浮動小数点数を返します。
8 * この関数は高速ですが、暗号学的に安全な乱数が必要な場合は random_int() や random_bytes() を使用してください。
9 *
10 * @return void
11 */
12function generateLcgRandomNumbers(): void
13{
14    echo "--- lcg_value() を使った擬似乱数の生成 ---" . PHP_EOL;
15    echo "この関数は、0.0から1.0の間のfloat値を返します。" . PHP_EOL . PHP_EOL;
16
17    // lcg_value() を数回呼び出して、異なる乱数が生成されることを示す
18    echo "1回目: " . lcg_value() . PHP_EOL;
19    echo "2回目: " . lcg_value() . PHP_EOL;
20    echo "3回目: " . lcg_value() . PHP_EOL . PHP_EOL;
21
22    // ループを使って、さらに多くの乱数を生成し表示する
23    echo "さらに10個の乱数を生成します:" . PHP_EOL;
24    for ($i = 1; $i <= 10; $i++) {
25        // sprintf を使用して、表示形式を整える (小数点以下15桁まで表示)
26        echo sprintf("乱数 %2d: %.15f", $i, lcg_value()) . PHP_EOL;
27    }
28
29    echo PHP_EOL . "-------------------------------------------" . PHP_EOL;
30    echo "注意: lcg_value() は引数をとりません。" . PHP_EOL;
31}
32
33// 関数を実行して、乱数生成のデモンストレーションを行う
34generateLcgRandomNumbers();

このサンプルコードは、PHPのlcg_value()関数を使って擬似乱数を生成する方法を示しています。lcg_value()関数は引数を一切取らず、呼び出すたびに0.0以上1.0未満の浮動小数点数（float型）を返します。

この関数は、線形合同法（Linear Congruential Generator）というアルゴリズムに基づいており、非常に高速に乱数を生成できる点が特徴です。しかし、その乱数は数学的なパターンを持つため、暗号学的に安全ではありません。パスワード生成やセキュリティ関連の用途で高い安全性が求められる場合には、random_int()やrandom_bytes()といった、より強固な乱数生成関数を使用することをお勧めします。

サンプルコードでは、lcg_value()関数を複数回呼び出し、その都度異なる乱数が生成される様子をデモンストレーションしています。また、forループを使って多数の乱数を生成し、sprintf()関数を用いて小数点以下15桁まで表示形式を整えている点も確認できます。このように、lcg_value()は単純で高速な乱数が必要な場合に利用される関数です。

Copy
1<?php
2
3/**
4 * lcg_value() 関数を使用して、線形合同法に基づく乱数を生成し表示するサンプル。
5 *
6 * lcg_value() は、0.0 (含む) から 1.0 (含まない) の間の浮動小数点数を返します。
7 * これは、他の乱数生成関数とは異なるアルゴリズムを使用しており、
8 * 特定の用途（例えば科学技術計算など）で利用されることがあります。
9 */
10function generateAndDisplayLcgValues(): void
11{
12    echo "lcg_value() 関数による乱数生成のデモンストレーション:\n";
13    echo "---------------------------------------------------\n";
14
15    // lcg_value() を呼び出して乱数を生成します。
16    // 引数は不要で、常に float 型の値を返します。
17    $randomNumber1 = lcg_value();
18    echo "1回目の乱数: " . $randomNumber1 . "\n";
19
20    // 複数回呼び出すことで、毎回異なる乱数が生成されることを確認できます。
21    $randomNumber2 = lcg_value();
22    echo "2回目の乱数: " . $randomNumber2 . "\n";
23
24    $randomNumber3 = lcg_value();
25    echo "3回目の乱数: " . $randomNumber3 . "\n";
26
27    echo "\n補足: lcg_value() は 0.0 以上 1.0 未満の浮動小数点数を生成します。\n";
28}
29
30// 上記の関数を実行して、lcg_value() の動作を確認します。
31generateAndDisplayLcgValues();
32
33?>

PHP 8のlcg_value()関数は、線形合同法に基づいて0.0以上1.0未満の浮動小数点数を生成する際に使用されます。この関数は引数を一切必要とせず、呼び出すたびにfloat型の乱数を返します。一般的な乱数生成関数とは異なるアルゴリズムを採用しており、科学技術計算のような特定の分野で利用されることがあります。

提供されたサンプルコードでは、generateAndDisplayLcgValues()関数内でlcg_value()を複数回呼び出し、その都度異なる乱数が生成される様子をデモンストレーションしています。$randomNumber1、$randomNumber2、$randomNumber3といった変数に代入された乱数が順に表示され、lcg_value()が毎回新しい0.0から1.0未満の浮動小数点数を生成していることを確認できます。このコードは、lcg_value()関数の基本的な使い方と挙動を初心者にも分かりやすく示すものです。