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

Copy
1<?php
2
3/**
4 * Random\IntervalBoundary::ClosedOpen を使用して、指定された範囲で浮動小数点数を生成する関数。
5 *
6 * この関数は、PHP 8.2 以降で利用可能な Random 拡張機能に依存します。
7 *
8 * @param float $min 乱数生成の最小値（この値は区間に含まれます）
9 * @param float $max 乱数生成の最大値（この値は区間に含まれません）
10 * @return float 指定された [min, max) の区間内で生成された乱数
11 */
12function generateFloatWithClosedOpen(float $min, float $max): float
13{
14    // ランダムな値を生成するための Randomizer クラスのインスタンスを作成します。
15    $randomizer = new Random\Randomizer();
16
17    // getFloat() メソッドを使用して浮動小数点数を生成します。
18    // 第3引数に Random\IntervalBoundary::ClosedOpen を指定することで、
19    // 生成される乱数が [min, max) の範囲、つまり「min を含むが max を含まない」
20    // 区間となるように動作します。
21    // 例: min=0.0, max=1.0 の場合、0.0 <= result < 1.0 となります。
22    return $randomizer->getFloat($min, $max, Random\IntervalBoundary::ClosedOpen);
23}
24
25// サンプルコードの使用例
26$minValue = 0.0;
27$maxValue = 100.0;
28
29echo "乱数生成の区間: [" . $minValue . ", " . $maxValue . ")\n";
30echo "意味: " . $minValue . " は含むが、" . $maxValue . " は含まない区間です。\n";
31
32// いくつかの乱数を生成して表示します
33for ($i = 0; $i < 3; $i++) {
34    $randomNumber = generateFloatWithClosedOpen($minValue, $maxValue);
35    echo "生成された乱数 (" . ($i + 1) . "回目): " . $randomNumber . "\n";
36}
37
38// 別な例: 負の数を含む区間
39$minValue2 = -5.0;
40$maxValue2 = 5.0;
41
42echo "\n乱数生成の区間: [" . $minValue2 . ", " . $maxValue2 . ")\n";
43echo "意味: " . $minValue2 . " は含むが、" . $maxValue2 . " は含まない区間です。\n";
44
45for ($i = 0; $i < 3; $i++) {
46    $randomNumber = generateFloatWithClosedOpen($minValue2, $maxValue2);
47    echo "生成された乱数 (" . ($i + 1) . "回目): " . $randomNumber . "\n";
48}
49
50?>

PHP 8.2以降で利用できるRandom拡張機能の一部であるRandom\IntervalBoundary::ClosedOpenは、乱数生成の区間（範囲）を指定するための定数です。この定数を使用すると、指定された最小値（$min）は生成される乱数に含まれますが、最大値（$max）は含まれない区間、具体的には[min, max)の範囲で乱数を生成できます。

サンプルコードのgenerateFloatWithClosedOpen関数は、この定数を使って浮動小数点数の乱数を生成する方法を示しています。この関数は、引数として乱数生成の最小値$minと最大値$maxを受け取ります。関数内では、Random\Randomizerクラスのインスタンスを作成し、そのgetFloatメソッドの第3引数にRandom\IntervalBoundary::ClosedOpenを指定します。これにより、$minで与えられた最小値を含み、$maxで与えられた最大値を含まない範囲の浮動小数点数が戻り値として返されます。例えば、$minが0.0で$maxが1.0の場合、生成される乱数は0.0以上1.0未満の数となります。この定数は、乱数の範囲を厳密に制御したい場合に非常に役立ちます。

Copy
1<?php
2
3/**
4 * データベース操作とPHP 8の乱数生成器を使用するサンプル関数。
5 *
6 * この関数は、PDO (PHP Data Objects) を使用してデータベースに接続し、
7 * データを挿入、取得した後、結果セットを解放するために `closeCursor()` メソッドを呼び出します。
8 * 挿入するデータの一部は、PHP 8で導入された `Random\Randomizer` クラスと
9 * `Random\IntervalBoundary::ClosedOpen` 定数を使って生成されます。
10 *
11 * システムエンジニアを目指す初心者向けに、データベース操作の基本的な流れと
12 * `closeCursor()` の役割、そしてPHP 8の新しい乱数生成の利用方法を示します。
13 */
14function runDatabaseOperationsWithRandomDataAndCloseCursor(): void
15{
16    // データベース接続情報 (必要に応じて変更してください)
17    // ここではメモリ内SQLiteデータベースを使用し、ファイルシステムへの変更を伴いません。
18    $dsn = 'sqlite::memory:';
19    $username = null; // SQLiteの場合は不要
20    $password = null; // SQLiteの場合は不要
21
22    try {
23        // 1. データベースに接続
24        // PDO::ATTR_ERRMODE を PDO::ERRMODE_EXCEPTION に設定することで、
25        // データベース操作中のエラーが発生した場合に例外をスローするようにします。
26        $pdo = new PDO($dsn, $username, $password, [
27            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
28            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC, // 結果を連想配列で取得
29        ]);
30        echo "データベースに接続しました。\n";
31
32        // 2. テーブルを作成
33        $pdo->exec('CREATE TABLE IF NOT EXISTS users (
34            id INTEGER PRIMARY KEY AUTOINCREMENT,
35            name TEXT NOT NULL,
36            score REAL NOT NULL
37        )');
38        echo "テーブル 'users' が作成または既に存在しています。\n";
39
40        // 3. PHP 8 の Random\Randomizer を使用してダミーデータを生成
41        $randomizer = new Random\Randomizer();
42        $userNamePrefix = 'User_';
43
44        // Random\IntervalBoundary::ClosedOpen 定数を使用して浮動小数点数を生成します。
45        // これは、乱数生成の範囲が「閉区間開始、開区間終了」であることを指定します。
46        // 例: 0.0 以上 100.0 未満の浮動小数点数を生成 (つまり [0.0, 100.0) )。
47        $score = $randomizer->getFloat(0.0, 100.0, Random\IntervalBoundary::ClosedOpen);
48        $name = $userNamePrefix . $randomizer->getInt(1000, 9999); // ユーザー名は整数乱数で生成
49
50        // 4. 生成したデータをデータベースに挿入 (プリペアドステートメントを使用)
51        $stmt = $pdo->prepare('INSERT INTO users (name, score) VALUES (:name, :score)');
52        $stmt->execute([':name' => $name, ':score' => $score]);
53        echo "データを挿入しました (Name: {$name}, Score: " . number_format($score, 2) . ").\n";
54
55        // 5. データベースからデータを取得
56        $stmt = $pdo->query('SELECT id, name, score FROM users');
57        echo "=== 挿入されたデータ ===\n";
58        while ($row = $stmt->fetch()) {
59            echo "ID: {$row['id']}, Name: {$row['name']}, Score: " . number_format($row['score'], 2) . "\n";
60        }
61        echo "======================\n";
62
63        // 6. カーソルを閉じる (closeCursor() の利用)
64        // PDOStatement::closeCursor() は、現在の結果セットを解放し、
65        // 同じ PDOStatement オブジェクトが別のクエリを実行できるようにします。
66        // 特に大量のデータを取得した場合に、メモリを解放するのに役立ちます。
67        $stmt->closeCursor();
68        echo "カーソルが閉じられました (PDOStatement::closeCursor() を呼び出し)。\n";
69
70        // closeCursor() の後、同じ $stmt オブジェクトを再利用して別のクエリを実行できます。
71        // 例: $stmt->execute([':name' => 'AnotherUser', ':score' => 50.0]);
72        // この例では再利用は省略します。
73
74    } catch (PDOException $e) {
75        // データベース関連のエラーをキャッチして表示
76        echo "データベースエラーが発生しました: " . $e->getMessage() . "\n";
77    } finally {
78        // 7. データベース接続を閉じる
79        // PDO オブジェクトに null を代入することで、明示的に接続を閉じます。
80        // スクリプト終了時に自動的に閉じられますが、明示することでリソース管理を明確にできます。
81        $pdo = null;
82        echo "データベース接続を閉じました。\n";
83    }
84}
85
86// 関数を実行して、一連の操作を開始します。
87runDatabaseOperationsWithRandomDataAndCloseCursor();

このサンプルコードは、PHPでデータベースを操作する基本的な手順と、PHP 8から導入された新しい乱数生成器の利用方法を示しています。まず、PDO（PHP Data Objects）を用いてSQLiteデータベースに接続し、ユーザー情報を格納するテーブルを作成します。データ挿入時には、PHP 8のRandom\Randomizerクラスを使用し、Random\IntervalBoundary::ClosedOpen定数を使ってスコアの乱数を生成します。この定数は、浮動小数点数などを生成する際に、数値の範囲が「開始値を含み、終了値を含まない」という閉区間・開区間（例: [0.0, 100.0)）で指定されることを意味します。これにより、予測可能で安全な乱数生成が可能になります。データ挿入後、データベースから情報を取得し、表示します。一連のデータベース操作の完了後、PDOStatement::closeCursor()メソッドを呼び出します。このメソッドは、取得した結果セットが占有していたデータベースリソースを解放し、同じPDOStatementオブジェクトを再利用できるようにするために重要です。特に大量のデータを扱う際に、メモリの効率的な管理に役立ちます。最後に、データベース接続を閉じることで、リソース管理を適切に行っています。初心者の方がデータベース操作とPHPの最新機能を学ぶ上で役立つ内容です。