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

Copy
1<?php
2
3// このコードはPHP 8.2以降で動作します。
4// Random\Randomizer クラスはPHP 8.2で導入されました。
5
6/**
7 * 指定された範囲のランダムな整数を生成し、表示します。
8 *
9 * Random\Randomizer::nextInt() メソッドは、暗号学的に安全な乱数ジェネレータからの
10 * 数値を利用して、指定された範囲の予測不可能な整数を生成します。
11 *
12 * @param int $min 乱数の最小値 (この値を含む)
13 * @param int $max 乱数の最大値 (この値を含む)
14 * @return void
15 */
16function generateAndDisplayRandomNumber(int $min, int $max): void
17{
18    // Randomizer クラスのインスタンスを作成します。
19    // 引数を指定しない場合、PHPが推奨するデフォルトの強力な乱数エンジンが使用されます。
20    $randomizer = new Random\Randomizer();
21
22    // nextInt() メソッドを呼び出し、$min と $max の間のランダムな整数を生成します。
23    $randomNumber = $randomizer->nextInt($min, $max);
24
25    echo "{$min} から {$max} の間のランダムな整数: {$randomNumber}\n";
26}
27
28// 使用例1: 1から100までのランダムな整数を生成
29generateAndDisplayRandomNumber(1, 100);
30
31// 使用例2: -50から50までのランダムな整数を生成
32generateAndDisplayRandomNumber(-50, 50);
33
34?>

PHPのRandom\Randomizer::nextInt()メソッドは、プログラミングにおいて指定された範囲で暗号学的に安全なランダムな整数を生成するために使用されます。この機能はPHP 8.2以降で導入されたRandom\Randomizerクラスに属しています。

このメソッドを利用するには、まずRandom\Randomizerクラスの新しいインスタンスを作成する必要があります。そして、作成したインスタンスからnextInt()メソッドを呼び出します。

nextInt()メソッドは二つの引数を受け取ります。一つ目の$minは生成される乱数の最小値を指定し、二つ目の$maxは最大値を指定します。これらの$minと$maxで指定された範囲（両端の値を含む）の中から、ランダムな整数が選ばれます。このメソッドは、生成されたint型のランダムな整数を戻り値として返します。

例えば、サンプルコードのgenerateAndDisplayRandomNumber関数では、このnextInt()メソッドを使って1から100や-50から50といった特定の範囲でランダムな数値を生成し、その結果を表示しています。これにより、ゲームの要素やセキュリティ関連の機能など、予測不能な数値が求められる様々な場面で、信頼性の高い乱数を手軽に生成することが可能です。

Copy
1<?php
2
3/**
4 * Random\Randomizer クラスを使用して、指定された範囲のランダムな整数を生成する例。
5 * このクラスは PHP 8.2 以降で利用可能です。
6 */
7function generateRandomNumberExample(int $min, int $max): void
8{
9    echo "--- 乱数生成の例: 範囲 [{$min}, {$max}] ---\n";
10
11    // Randomizer のインスタンスを作成します。
12    // デフォルトでは、セキュリティを考慮した乱数エンジンが使用されます。
13    $randomizer = new Random\Randomizer();
14
15    // nextInt() メソッドを使用して、指定された min (含む) から max (含む) の範囲で整数を生成します。
16    $randomNumber = $randomizer->nextInt($min, $max);
17
18    echo "生成された乱数: " . $randomNumber . "\n\n";
19}
20
21// 例1: 1から10までのランダムな整数を生成する
22generateRandomNumberExample(1, 10);
23
24// 例2: 100から200までのランダムな整数を生成する
25generateRandomNumberExample(100, 200);
26
27// 例3: サイコロの目をシミュレート（1から6）
28generateRandomNumberExample(1, 6);
29
30?>

PHP 8.2以降で利用可能なRandom\Randomizer::nextIntメソッドは、指定した範囲内でランダムな整数を安全に生成するために使用されます。このメソッドを利用するには、まずRandom\Randomizerクラスのインスタンスを作成します。このインスタンスは、セキュリティを考慮した強力な乱数生成エンジンを内部で使用しており、一般的な乱数関数に比べて、より予測困難で高品質な乱数を生成します。

nextIntメソッドは、2つの整数型引数$minと$maxを受け取ります。$minは生成される乱数の最小値を、$maxは最大値をそれぞれ指定します。このメソッドは、$minと$maxの両端を含む範囲で、均等に分布するランダムな整数を戻り値として返します。例えば、$randomizer->nextInt(1, 10)と指定すれば、1から10までのいずれかの整数が生成されます。

サンプルコードでは、このnextIntメソッドを使って、1から10、100から200、そしてサイコロの目をシミュレートする1から6の範囲で乱数を生成する具体的な例を示しています。これにより、ゲームやシミュレーション、ランダムな選択など、様々な場面で安全かつ簡単に乱数を活用できます。