【PHP8.x】Random\Randomizer::engineプロパティの使い方

engineプロパティは、Random\Randomizerクラス内で使用される乱数生成エンジンを保持するプロパティです。

このプロパティは、PHP 8で導入されたRandom\Randomizerインスタンスが、実際に乱数バイト列を生成するために利用するRandom\Engineインターフェースを実装したオブジェクトを格納します。Random\Randomizerクラスは、ユーザーが指定した範囲や型の乱数を生成する上位レベルの機能を提供しますが、その基盤となる生の乱数バイト列は、このengineプロパティに保持されたオブジェクトが担当します。

開発者は、Random\Randomizerオブジェクトを初期化する際に、このengineプロパティに、Random\Engineインターフェースを実装した任意の乱数生成エンジン（例えば、暗号学的に安全なRandom\Engine\Secureや、より高速なRandom\Engine\Mt19937など）を渡すことができます。これにより、プログラムの要件に応じて、乱数生成のアルゴリズムを柔軟に選択・切り替えることが可能になります。

つまり、engineプロパティは、Random\Randomizerがどのような「乱数の源」を使うかを決定する重要な役割を果たし、セキュアな乱数が必要な場合や、特定のパフォーマンス要件がある場合に、その振る舞いを細かく制御するための窓口となります。この設計により、乱数生成ロジックと上位の加工ロジックが分離され、コードの再利用性やテスト容易性が向上しています。

Copy
1<?php
2
3use Random\Randomizer;
4use Random\Engine\Mt19937;
5
6$randomizer = new Randomizer(new Mt19937());
7
8$engine = $randomizer->engine;
9
10?>

引数なし

引数はありません

Random\Engine

Random\Randomizer::engine プロパティは、乱数生成に使用される Random\Engine インターフェースを実装したオブジェクトを返します。