【PHP8.x】Random\IntervalBoundary::OpenOpen定数の使い方

Copy
1<?php
2
3/**
4 * Random\IntervalBoundary::OpenOpen 定数を使用して、
5 * 指定された開区間 (両端を含まない) で浮動小数点数の乱数を生成し表示します。
6 *
7 * これは、システムエンジニアを目指す初心者向けに、
8 * PHP 8.2 以降で利用可能な安全な乱数生成と境界指定の例を示します。
9 */
10function demonstrateOpenOpenIntervalBoundary(): void
11{
12    // 安全な乱数を生成するための Randomizer クラスをインスタンス化します。
13    $randomizer = new Random\Randomizer();
14
15    // 乱数を生成する区間の最小値と最大値を定義します。
16    $min = 0.0;
17    $max = 1.0;
18
19    // Random\IntervalBoundary::OpenOpen を指定します。
20    // これは、(min, max) のように両端 (min と max) を含まない開区間を意味します。
21    $boundaryType = Random\IntervalBoundary::OpenOpen;
22
23    // 指定された開区間で浮動小数点数の乱数を生成します。
24    $randomNumber = $randomizer->getFloat($min, $max, $boundaryType);
25
26    echo "--- Random Float Generation Example ---\n";
27    echo "生成された乱数: " . $randomNumber . "\n";
28    echo "指定区間: (" . $min . ", " . $max . ")\n";
29    echo "区間境界タイプ: " . $boundaryType->name . " (両端を含まない開区間)\n";
30
31    // 乱数が本当に指定された開区間内にあるか確認します。
32    if ($randomNumber > $min && $randomNumber < $max) {
33        echo "確認: 乱数は期待通り開区間内にあります。\n";
34    } else {
35        echo "確認: 警告！乱数が期待される開区間外にあります。\n";
36    }
37    echo "---------------------------------------\n";
38}
39
40// サンプルコードを実行します。
41demonstrateOpenOpenIntervalBoundary();
42
43?>

このPHPサンプルコードは、PHP 8.2以降で利用できる、安全な乱数を生成する新しい機能と、Random\IntervalBoundary::OpenOpen定数の使い方を初心者向けに解説しています。

Random\IntervalBoundary::OpenOpenは、乱数を生成する範囲（区間）の境界の扱い方を指定する定数の一つです。この定数には引数はなく、Random\IntervalBoundary型のオブジェクトを戻り値として返します。OpenOpenを指定すると、乱数を生成する区間において、「両端を含まない」開区間が適用されます。例えば、0.0から1.0の範囲で乱数を生成する場合、0.0も1.0も結果には含まれず、必ず0.0より大きく1.0より小さい数値が生成されます。数学の表記では(min, max)に相当します。

サンプルコードでは、まずRandom\Randomizerクラスをインスタンス化し、信頼性の高い乱数生成器を用意しています。その後、乱数を生成する最小値$minと最大値$maxを定義し、境界タイプとしてRandom\IntervalBoundary::OpenOpenを指定します。$randomizer->getFloat()メソッドを使うことで、これらの設定に基づき、指定された開区間内で浮動小数点数の乱数が生成されます。生成された乱数が実際に両端を含まない区間内にあるかをプログラムで確認しており、境界値を含まない厳密な乱数が必要な場面で、この定数が役立ちます。

Copy
1<?php
2
3// この定数はPHP 8.2以降で利用可能です。
4// Random\IntervalBoundary::OpenOpen は、乱数生成の範囲を「両端を含まない開区間」として指定します。
5// 例えば、getInt(1, 10, Random\IntervalBoundary::OpenOpen) の場合、2から9までの整数が生成されます。
6
7/**
8 * OpenAPIを意識したAPIのレスポンスとして、ランダムな整数を生成する関数。
9 *
10 * この例では、APIのバージョン番号やIDなど、特定の範囲内のランダムな整数を
11 * モックとして生成するシナリオを想定しています。
12 * Random\IntervalBoundary::OpenOpen を使用することで、指定された最小値と最大値の両端を含まない範囲で
13 * 整数を生成する方法を示します。
14 *
15 * @param int $min 乱数を生成する最小値（この値は含まれません）
16 * @param int $max 乱数を生成する最大値（この値は含まれません）
17 * @return int 生成されたランダムな整数
18 */
19function generateRandomApiResponseValue(int $min, int $max): int
20{
21    // Randomizerクラスは、より安全で柔軟な乱数生成を提供します。
22    // PHP 8.2以降で利用可能です。
23    $randomizer = new Random\Randomizer();
24
25    // Random\IntervalBoundary::OpenOpen を使用して、
26    // $min と $max の両端を含まない範囲で整数を生成します。
27    // 例えば $min=1, $max=10 の場合、2, 3, ..., 9 のいずれかが生成されます。
28    $randomNumber = $randomizer->getInt($min, $max, Random\IntervalBoundary::OpenOpen);
29
30    return $randomNumber;
31}
32
33// サンプル使用例:
34// APIのレスポンスとして、バージョン番号を2から9の範囲でランダムに生成するシナリオ
35// (指定された最小値1と最大値10は含まれません)
36$minVersion = 1;
37$maxVersion = 10;
38$apiResponseVersion = generateRandomApiResponseValue($minVersion, $maxVersion);
39
40echo "OpenAPIモックのバージョン番号 (指定範囲: {$minVersion}と{$maxVersion}を含まない): " . $apiResponseVersion . PHP_EOL;
41
42// 別の例: 0から100の間で、0と100を含まないランダムな数値を生成
43$minValue = 0;
44$maxValue = 100;
45$apiResponseId = generateRandomApiResponseValue($minValue, $maxValue);
46
47echo "OpenAPIモックのID (指定範囲: {$minValue}と{$maxValue}を含まない): " . $apiResponseId . PHP_EOL;

このPHPサンプルコードは、OpenAPIを意識したAPIのレスポンスとして、特定の範囲内のランダムな整数を生成する方法を示しています。特にPHP 8.2以降で導入されたRandom\IntervalBoundary::OpenOpen定数を使用し、乱数生成の範囲を「両端を含まない開区間」として指定できる点が特徴です。

Random\IntervalBoundary::OpenOpenは、乱数を生成する際に指定する最小値と最大値の両方を、生成対象の範囲から除外したい場合に利用します。例えば、getInt(1, 10, Random\IntervalBoundary::OpenOpen)と設定すると、1と10を含まない2から9までの整数が生成されます。

generateRandomApiResponseValue関数は、$min（乱数を生成する最小値）と$max（最大値）を引数として受け取りますが、これらの値は生成される乱数には含まれません。関数内部では、PHP 8.2以降で利用可能なRandom\Randomizerクラスを用いて、より安全で柔軟な乱数を生成しています。この関数は、指定された範囲の両端を含まない単一のランダムな整数を戻り値として返します。

コードの後半では、APIのバージョン番号を1と10を含まない2から9の範囲で、またAPIのIDを0と100を含まない1から99の範囲で、それぞれランダムに生成する具体的な使用例を通じて、この機能がどのように活用できるかを示しています。