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

Copy
1<?php
2
3/**
4 * 指定された範囲の乱数を生成する
5 *
6 * @param int $min 最小値 (含む)
7 * @param int $max 最大値 (含む)
8 * @return int 生成された乱数
9 * @throws Exception 乱数生成に失敗した場合
10 */
11function generateRandomInteger(int $min, int $max): int
12{
13  try {
14    return random_int($min, $max);
15  } catch (Exception $e) {
16    // 乱数生成に失敗した場合の処理
17    error_log("乱数生成エラー: " . $e->getMessage());
18    throw $e; // 例外を再スロー
19  }
20}
21
22// 使用例
23try {
24  $randomNumber = generateRandomInteger(1, 100);
25  echo "生成された乱数: " . $randomNumber . PHP_EOL;
26} catch (Exception $e) {
27  echo "エラーが発生しました: " . $e->getMessage() . PHP_EOL;
28}

PHPのrandom_int関数は、指定された範囲内の暗号学的に安全な乱数を生成するために使用されます。この関数は、予測不可能な乱数を必要とする場面、例えばパスワード生成やセキュリティ関連の処理などに適しています。

サンプルコードでは、generateRandomIntegerという独自の関数を定義し、random_int関数をラップしています。この関数は、$minと$maxという2つの整数型の引数を受け取ります。$minは乱数の最小値（これを含む）、$maxは乱数の最大値（これも含む）を指定します。

random_int関数は、指定された範囲内の乱数を整数型（int）で返します。もし乱数生成に失敗した場合、Exceptionが発生する可能性があります。

サンプルコードでは、try...catchブロックを使用して例外処理を行っています。random_int関数が例外をスローした場合、catchブロック内でエラーログを出力し、例外を再スローすることで、上位の呼び出し元にエラーを伝えます。

使用例では、generateRandomInteger(1, 100)を呼び出し、1から100までの乱数を生成しています。生成された乱数は$randomNumber変数に格納され、画面に出力されます。例外が発生した場合も、エラーメッセージが画面に出力されます。PHP_EOLは改行コードを表し、出力結果を見やすくするために使用しています。random_int関数は、より安全な乱数が必要な場合に使用されるべき関数です。

Copy
1<?php
2
3/**
4 * 指定された範囲の乱数を生成するサンプルコード
5 */
6function generateRandomInteger(int $min, int $max): int
7{
8  try {
9    // random_int 関数を使用して、指定された範囲の安全な乱数を生成します。
10    $randomInt = random_int($min, $max);
11    return $randomInt;
12  } catch (Exception $e) {
13    // 乱数生成に失敗した場合、エラーメッセージを表示して -1 を返します。
14    error_log("Failed to generate random integer: " . $e->getMessage());
15    return -1;
16  }
17}
18
19// 最小値と最大値を設定します。
20$min = 1;
21$max = 100;
22
23// 乱数を生成します。
24$randomNumber = generateRandomInteger($min, $max);
25
26// 生成された乱数を表示します。
27if ($randomNumber !== -1) {
28  echo "生成された乱数: " . $randomNumber . PHP_EOL;
29} else {
30  echo "乱数の生成に失敗しました。" . PHP_EOL;
31}
32?>

このPHPのサンプルコードは、random_int関数を使用して、指定された範囲の安全な乱数を生成する方法を示しています。random_int関数は、暗号学的に安全な擬似乱数ジェネレータを使用しており、予測が困難な乱数を生成するのに適しています。

random_int関数は、2つの整数型の引数 $min と $max を受け取ります。$min は乱数の最小値を、$max は乱数の最大値を指定します。この関数は、$min 以上 $max 以下の整数型の乱数を返します。

サンプルコードでは、generateRandomIntegerという関数を定義し、この関数内でrandom_int関数を呼び出しています。generateRandomInteger関数も $min と $max を引数として受け取り、生成された乱数を返します。

乱数生成に失敗した場合（例えば、$min が $max より大きい場合など）、random_int関数は例外をスローします。サンプルコードでは、try-catch ブロックを使用してこの例外をキャッチし、エラーログにメッセージを出力した後、-1を返しています。

最後に、生成された乱数が -1 でない場合（つまり、正常に乱数が生成された場合）、生成された乱数を表示します。-1 の場合は、乱数生成に失敗した旨のメッセージを表示します。このサンプルコードは、指定範囲内の安全な乱数を生成し、その結果を適切に処理する方法を理解するのに役立ちます。

Copy
1<?php
2
3/**
4 * 指定された最小値と最大値の範囲内で、暗号学的に安全なランダムな整数を生成し、表示します。
5 *
6 * システムエンジニアを目指す初心者の方へ:
7 * random_int関数は、予測不可能な乱数が必要なセキュリティ関連の機能（例: パスワードリセットトークン、セッションID）で
8 * 使用される、信頼性の高い乱数を生成するための関数です。
9 *
10 * @param int $min 範囲の最小値（この値を含む）
11 * @param int $max 範囲の最大値（この値を含む）
12 * @return void
13 */
14function generateSecureRandomInt(int $min, int $max): void
15{
16    // random_int関数を呼び出し、指定された$minと$maxの範囲（両端を含む）で
17    // 暗号学的に安全なランダムな整数を生成します。
18    $randomNumber = random_int($min, $max);
19
20    // 生成された乱数とその範囲を出力します。
21    echo "生成されたランダムな整数: " . $randomNumber . " (範囲: " . $min . " から " . $max . ")\n";
22}
23
24// 関数の呼び出し例1: 1から100までのランダムな整数を生成し、表示します。
25generateSecureRandomInt(1, 100);
26
27// 関数の呼び出し例2: 1000から2000までのランダムな整数を生成し、表示します。
28generateSecureRandomInt(1000, 2000);
29
30?>

PHP 8で提供されるrandom_int関数は、指定された範囲内で「暗号学的に安全な」ランダムな整数を生成するために使用されます。この関数は、予測不可能な乱数が必要なセキュリティ関連の機能、例えばパスワードリセットトークンやセッションIDの生成など、信頼性が求められる場面で特に重要です。

引数には、生成したいランダムな整数の範囲を示す「最小値」を$minに、そして「最大値」を$maxに、それぞれ整数型で渡します。random_int関数は、これらの$minと$maxを含む範囲（両端を含む）の中から、ランダムに選ばれた整数を戻り値として返します。

サンプルコードでは、generateSecureRandomInt関数内でrandom_intを呼び出し、その動作を確認できます。例えば、generateSecureRandomInt(1, 100)を実行すると、1から100までの間の整数がランダムに生成され、その結果が表示されます。同様に、generateSecureRandomInt(1000, 2000)では1000から2000の範囲でランダムな整数が生成されます。このように、開発者はこの関数を利用して、簡単にセキュリティ要件を満たす信頼性の高い乱数をアプリケーションに組み込むことができます。

Copy
1<?php
2
3// このコードは、指定された範囲内で暗号学的に安全なランダムな整数を生成します。
4
5// 乱数生成の最小値と最大値を定義します。
6$minValue = 1;  // 生成される乱数の最小値（この値を含む）
7$maxValue = 100; // 生成される乱数の最大値（この値を含む）
8
9try {
10    // random_int() 関数を使用して、指定された範囲 ($minValue から $maxValue) の
11    // ランダムな整数を生成します。この関数は暗号学的に安全な乱数を提供します。
12    $randomNumber = random_int($minValue, $maxValue);
13
14    // 生成された乱数と、設定した範囲を出力します。
15    echo "生成されたランダムな整数: " . $randomNumber . "\n";
16    echo "範囲: [" . $minValue . ", " . $maxValue . "]\n";
17
18} catch (Throwable $e) {
19    // random_int() の実行中にエラーが発生した場合（例: 引数の型が不正、
20    // または十分なエントロピー源がない場合など）のエラーハンドリングを行います。
21    echo "エラー: 乱数生成に失敗しました。 " . $e->getMessage() . "\n";
22}
23
24?>

PHP 8のrandom_int関数は、指定された範囲内で暗号学的に安全なランダムな整数を生成するために使用されます。この関数は、予測不可能な乱数が必要とされるセキュリティ関連の機能などにおいて、信頼性の高い乱数を提供します。

random_int関数は二つのint型の引数を取ります。一つ目の$minは生成される乱数の最小値を、二つ目の$maxは最大値をそれぞれ指定します。これらの値は生成される乱数に含まれます。関数が正常に実行されると、指定された範囲内のランダムな整数がint型の戻り値として返されます。

提示されたサンプルコードでは、$minValueを1、$maxValueを100と設定し、random_int()関数を呼び出すことで1から100までの乱数を生成しています。生成された乱数は$randomNumber変数に格納され、その結果と設定した範囲が出力されます。また、try...catchブロックを使用することで、引数の型が不正であったり、システム上で乱数生成に必要な十分なエントロピー源が得られないなどの問題が発生した場合に、エラーを適切に捕捉し処理する堅牢なコードの書き方を示しています。