【PHP8.x】Random\Randomizer::getInt()メソッドの使い方

Copy
1<?php
2
3/**
4 * Random\Randomizer::getInt メソッドを使用して、指定範囲の安全な乱数を生成するサンプルコードです。
5 * システムエンジニアを目指す初心者の方にも理解しやすいよう、基本的な使い方を簡潔に示します。
6 * このコードは PHP 8.2 以降で動作します。
7 */
8class RandomNumberGenerator
9{
10    /**
11     * 安全な乱数生成を行う Randomizer のインスタンス。
12     */
13    private Random\Randomizer $randomizer;
14
15    /**
16     * RandomNumberGenerator クラスのコンストラクタです。
17     * Random\Randomizer のインスタンスを初期化します。
18     * 引数なしの場合、デフォルトで暗号学的に安全な乱数エンジン (Random\Engine\Secure) が使用されます。
19     */
20    public function __construct()
21    {
22        $this->randomizer = new Random\Randomizer();
23    }
24
25    /**
26     * 指定された最小値 ($min) と最大値 ($max) の範囲内で、
27     * 安全な整数乱数を生成して標準出力に表示します。
28     *
29     * @param int $min 乱数の最小値 (この値を含む)
30     * @param int $max 乱数の最大値 (この値を含む)
31     * @return void
32     */
33    public function generateAndDisplayRandomInt(int $min, int $max): void
34    {
35        // Random\Randomizer::getInt メソッドを呼び出し、指定された範囲で乱数を生成します。
36        // このメソッドは、$min と $max を含む範囲で均一な乱数を返します。
37        $randomNumber = $this->randomizer->getInt($min, $max);
38
39        echo "指定された範囲 {$min} から {$max} の安全な乱数: {$randomNumber}" . PHP_EOL;
40    }
41
42    /**
43     * 指定された回数、乱数を生成して表示する例です。
44     * 複数の乱数を生成する際の動作を確認できます。
45     *
46     * @param int $min 乱数の最小値 (この値を含む)
47     * @param int $max 乱数の最大値 (この値を含む)
48     * @param int $count 生成する乱数の回数
49     * @return void
50     */
51    public function generateMultipleRandomInts(int $min, int $max, int $count): void
52    {
53        echo "--- 複数回の乱数生成例 ({$min} から {$max}, {$count}回) ---" . PHP_EOL;
54        for ($i = 1; $i <= $count; $i++) {
55            $randomNumber = $this->randomizer->getInt($min, $max);
56            echo "生成された乱数 " . $i . ": {$randomNumber}" . PHP_EOL;
57        }
58        echo "-----------------------------------" . PHP_EOL;
59    }
60}
61
62// -----------------------------------------------------------------------------
63// サンプルコードとして単体で動作させるための実行部分
64// -----------------------------------------------------------------------------
65
66// RandomNumberGenerator クラスのインスタンスを作成します。
67$generator = new RandomNumberGenerator();
68
69// 1. 基本的な乱数生成の例: 1から100の間の乱数を生成します。
70echo "--- 基本的な乱数生成の例 ---" . PHP_EOL;
71$generator->generateAndDisplayRandomInt(1, 100);
72// マイナスの値を含む範囲の乱数も生成できます。
73$generator->generateAndDisplayRandomInt(-50, 50);
74echo "--------------------------" . PHP_EOL . PHP_EOL;
75
76// 2. 複数回の乱数生成の例: 1から6の間の乱数 (サイコロの目をイメージ) を5回生成します。
77$generator->generateMultipleRandomInts(1, 6, 5);
78
79// 3. 別の範囲と回数で複数回生成する例: 1000から9999の間の乱数を3回生成します。
80$generator->generateMultipleRandomInts(1000, 9999, 3);
81
82?>

PHP 8.2以降で利用可能なRandom\Randomizer::getIntメソッドは、指定された整数範囲内で暗号学的に安全な乱数を生成するために使用します。このメソッドは、予測不可能な信頼性の高い乱数を手軽に取得できる点が特徴です。

この機能を使用するには、まずRandom\Randomizerクラスのインスタンスを作成します。このインスタンスが乱数生成の基盤となります。そして、作成したインスタンスからgetIntメソッドを呼び出します。

getIntメソッドには、二つの引数$minと$maxを整数で指定します。$minは生成される乱数の最小値（この値を含む）、$maxは最大値（この値を含む）をそれぞれ表します。例えば、getInt(1, 100)と指定すると、1から100までの整数が均一にランダムに選ばれて返されます。

戻り値はint型で、指定された$minと$maxの範囲内のランダムな整数となります。システムエンジニアを目指す方にとって、パスワード生成、セキュリティトークン発行、統計シミュレーションなど、信頼性のある乱数が必要な様々なアプリケーションでこのメソッドは非常に有効です。

Copy
1<?php
2
3// PHP 8.2 以降で利用可能な Random\Randomizer クラスを使用します。
4// このクラスは、セキュリティを考慮した安全な乱数を生成するために推奨されます。
5
6// Random\Randomizer のインスタンスを作成します。
7// これにより、デフォルトで安全な乱数エンジン（Random\Engine\Secure）が初期化されます。
8$randomizer = new Random\Randomizer();
9
10// 乱数を生成する範囲の最小値と最大値を定義します。
11// 例えば、1から100までの整数を生成したい場合。
12$min = 1;
13$max = 100;
14
15// Random\Randomizer::getInt() メソッドを使用して、
16// 指定された範囲（$min と $max を含む）でランダムな整数を生成します。
17$randomNumber = $randomizer->getInt($min, $max);
18
19// 生成された乱数を表示します。
20echo "{$min} から {$max} の範囲で生成されたランダムな整数: " . $randomNumber . PHP_EOL;
21
22?>

PHPのRandom\Randomizer::getIntメソッドは、指定した範囲内で安全なランダムな整数を生成するために使用されます。このサンプルコードは、その具体的な使い方を示しています。

まず、PHP 8.2以降で導入されたRandom\Randomizerクラスのインスタンスを作成します。このクラスは、セキュリティを考慮した予測されにくい強力な乱数を生成する際に推奨される方法です。

次に、getIntメソッドに渡す二つの引数を定義します。一つ目のint $minは、生成したい乱数の最小値を整数で指定します。二つ目のint $maxは、最大値を整数で指定します。getIntメソッドは、$minから$maxまでの範囲（両端の値を含む）で、均等な確率でランダムな整数を選び出します。

そして、$randomizerインスタンスを通じてgetIntメソッドを呼び出し、$minと$maxを引数として渡すことで乱数が生成されます。このメソッドの戻り値はint型で、生成されたランダムな整数です。

最終的に、echo文によって、設定した範囲と実際に生成された乱数の値が表示されます。この機能は、ゲームのサイコロの目や抽選番号、テストデータの生成など、さまざまな場面で活用できる基本的な乱数生成の手法です。