PHP マニュアル: 正の整数を取得する

public int Random\Randomizer::nextInt()

警告

この関数は、現在のところ詳細な情報はありません。引数のリストのみが記述されています。

この関数にはパラメータはありません。

Random\Engine::generate が返したバイト数に応じて、 0 から最大値までの正の整数を返します。正確な最大値は、2^{$engine_bytes * 8 - 1} - 1 で計算できます。

不整合を避けるため、32ビットの PHP は Random\Engine::generate の出力サイズが 32ビットを超えた場合、 Random\RandomException をスローします。なぜなら、選択した整数値を欠けることなく返せないからです。この振る舞いは、64ビットネイティブのエンジン Random\Engine\PcgOneseq128XslRr64 と Random\Engine\Xoshiro256StarStar に影響します。 4バイト以上のランダムな値を返す、ユーザーが使えるあらゆるエンジンにも影響します。
Random\Randomizer::$engine に存在する Random\Engine::generate メソッドがスローした、あらゆる Throwable がスローされます。

例1 Random\Randomizer::nextInt の例

<?php
$r = new \Random\Randomizer();

// "次の" 整数をランダムに出力します
echo $r->nextInt(), "\n";
?>

上の例の出力は、たとえば以下のようになります。

8041689838856078718