【PHP8.x】MT_RAND_PHP定数の使い方

Copy
1<?php
2
3/**
4 * PHPの乱数生成関数 mt_rand() と MT_RAND_PHP 定数の使用例。
5 *
6 * MT_RAND_PHP 定数は、PHP 7.1 より前のバージョンの mt_rand() の動作を再現するために、
7 * mt_srand() 関数で乱数生成アルゴリズムのモードを指定する際に使用されます。
8 * 主に古いPHPコードとの互換性を保ちたい場合に利用されます。
9 */
10function demonstrateMtRandModes(): void
11{
12    echo "--- mt_rand() の基本的な使用例 ---\n";
13    // mt_rand() は、メルセンヌ・ツイスターアルゴリズムを使用して乱数を生成します。
14    // 引数なしの場合、0 から mt_getrandmax() までの範囲で乱数を生成します。
15    echo "ランダムな整数 (デフォルト範囲): " . mt_rand() . "\n";
16
17    // 最小値と最大値を指定することで、特定の範囲の乱数を生成できます。
18    echo "1から100のランダムな整数 (デフォルトモード): " . mt_rand(1, 100) . "\n\n";
19
20    echo "--- mt_srand() と乱数生成アルゴリズムのモード設定 ---\n";
21
22    // シード値は乱数系列を初期化し、同じシードからは同じ乱数系列が生成されます。
23    // ただし、乱数生成モードが異なれば、同じシードでも異なる系列になります。
24    $seed = 12345;
25
26    // 1. 現在のPHPバージョンのデフォルトアルゴリズムを使用
27    // mt_srand() の第2引数を省略するか、MT_RAND_MT19937 を指定した場合と同じ動作です。
28    echo "【現在のPHPバージョンのデフォルトモード】\n";
29    mt_srand($seed); // シード値を設定
30    echo "シード " . $seed . " で生成された乱数1: " . mt_rand(0, 1000) . "\n";
31    echo "シード " . $seed . " で生成された乱数2: " . mt_rand(0, 1000) . "\n\n";
32
33    // 2. MT_RAND_PHP モードを使用
34    // このモードは、PHP 7.1 以前の mt_rand() の動作を再現します。
35    // 古いPHPバージョンで生成された乱数系列を再現したい場合に役立ちます。
36    echo "【MT_RAND_PHP モード (PHP 7.1 以前の互換モード)】\n";
37    mt_srand($seed, MT_RAND_PHP); // MT_RAND_PHP モードでシードを設定
38    echo "シード " . $seed . " で生成された乱数1 (MT_RAND_PHP): " . mt_rand(0, 1000) . "\n";
39    echo "シード " . $seed . " で生成された乱数2 (MT_RAND_PHP): " . mt_rand(0, 1000) . "\n\n";
40
41    echo "補足:\n";
42    echo "- 同じシード値でも、モードが異なると生成される乱数系列は異なります。\n";
43    echo "- MT_RAND_PHP モードは、主に下位互換性のため使用されます。\n";
44}
45
46// 関数を実行して、mt_rand() と MT_RAND_PHP 定数の動作を確認します。
47demonstrateMtRandModes();

PHPのmt_rand()関数は、メルセンヌ・ツイスターアルゴリズムを用いて疑似乱数を生成します。引数なしでは0からmt_getrandmax()までの、引数に最小値と最大値を指定した場合はその範囲内の整数をint型で返します。

mt_srand()関数は、乱数生成の開始点となるシード値を設定し、同じシードからは同じ乱数系列が生成されます。この関数の第2引数で乱数生成モードを指定できます。

MT_RAND_PHP定数は、mt_srand()と組み合わせて使用するモードの一つで、PHP 7.1より前のmt_rand()の動作を再現します。これは、主に古いPHPコードとの互換性を保ちたい場合に役立ちます。

サンプルコードでは、mt_rand()の基本的な使い方に加え、mt_srand()でシード値とモードを設定し、デフォルトモードとMT_RAND_PHPモードで乱数系列が異なることを示しています。このMT_RAND_PHP定数は、PHP 7.1以前の動作を再現し、下位互換性を確保するために利用されます。

Copy
1<?php
2
3/**
4 * PHPの乱数生成関数 rand() と mt_rand() の違いを比較するサンプルコード。
5 * PHP 8 環境における両関数の振る舞い、およびMT_RAND_PHP定数の役割を説明します。
6 */
7function demonstrateRandomNumberGeneration(int $min = 1, int $max = 100): void
8{
9    echo "--- 乱数生成関数の比較 (PHP 8) ---\n";
10    echo "PHP 7.1以降、rand()関数はmt_rand()関数のエイリアスとなりました。\n";
11    echo "そのため、両方の関数は同じ高品質なメルセンヌ・ツイスター乱数生成アルゴリズムを使用します。\n";
12    echo "同じシードを設定した場合、両関数は同じ乱数シーケンスを生成します。\n\n";
13
14    // MT_RAND_PHP 定数は、PHP 7.1より前のrand()が使用していた低品質なリニア合同法乱数生成アルゴリズムの
15    // 振る舞いを指す歴史的な定数です。
16    // 現在のPHP 8において、mt_rand()関数のアルゴリズムを指定するために直接使用されることはありません。
17    echo "定数 MT_RAND_PHP の値: " . MT_RAND_PHP . " (整数)\n\n";
18
19    $seed = 12345;
20
21    echo "--- rand() の出力 (シード: {$seed}) ---\n";
22    // srand() は rand() のシードを設定しますが、PHP 7.1以降はmt_srand()と同様に動作します。
23    srand($seed);
24    for ($i = 0; $i < 5; $i++) {
25        echo "rand(): " . rand($min, $max) . "\n";
26    }
27    echo "\n";
28
29    echo "--- mt_rand() の出力 (シード: {$seed}) ---\n";
30    // mt_srand() に同じシードを設定することで、rand()と同じ乱数シーケンスが生成されることを確認します。
31    mt_srand($seed);
32    for ($i = 0; $i < 5; $i++) {
33        echo "mt_rand(): " . mt_rand($min, $max) . "\n";
34    }
35    echo "\n";
36
37    echo "--- シードなしのランダムな出力 (毎回異なる可能性があります) ---\n";
38    // シードが設定されていない場合、システムからのエントロピーに基づいて乱数が生成されます。
39    echo "rand(): " . rand($min, $max) . "\n";
40    echo "mt_rand(): " . mt_rand($min, $max) . "\n";
41    echo "\n";
42
43    echo "結論:\n";
44    echo "- PHP 7.1以降ではrand()とmt_rand()は実質的に同じであり、どちらも高品質な乱数を生成します。\n";
45    echo "- 通常はmt_rand()の使用が推奨されますが、rand()を使用しても品質に差はありません。\n";
46    echo "- MT_RAND_PHP定数は、主に古いPHPバージョンのrand()の振る舞いを指す歴史的な意味を持ちます。\n";
47    echo "- 暗号学的に安全な乱数が必要な場合は、random_int()やrandom_bytes()を使用してください。\n";
48}
49
50// 関数を実行して結果を表示
51demonstrateRandomNumberGeneration();

このサンプルコードは、PHP 8環境における乱数生成関数rand()とmt_rand()の動作、および定数MT_RAND_PHPの役割を説明しています。PHP 7.1以降、rand()関数はmt_rand()関数のエイリアス（別名）となりました。そのため、両関数は現在、同じ高品質なメルセンヌ・ツイスターアルゴリズムを用いて乱数を生成します。同じシード（乱数生成の基準となる初期値）を設定すると、rand()とmt_rand()は全く同じ乱数シーケンスを生成することを確認できます。

定数MT_RAND_PHPは引数を取らず整数値を返しますが、これはPHP 7.1より前のrand()が使用していた低品質な乱数アルゴリズムを指す歴史的な定数です。現在のPHP 8において、この定数がmt_rand()のアルゴリズム指定に直接使われることはありません。

サンプルコードでは、srand()やmt_srand()でシードを設定し、両関数が同じ乱数を出力する様子を示します。また、シードを設定しない場合は、システムからのエントロピーに基づいて毎回異なる乱数が生成されます。

結論として、PHP 7.1以降ではrand()とmt_rand()の機能や品質に違いはなく、どちらを使用しても問題ありませんが、一般的にはmt_rand()の使用が推奨されます。暗号学的に安全な乱数が必要な場合は、random_int()やrandom_bytes()などの関数を使用してください。