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

Copy
1<?php
2
3/**
4 * Random\IntervalBoundary::OpenClosed 定数を使用して、乱数を生成するサンプルコード。
5 *
6 * この定数は、乱数生成の範囲の下限が開いており (より大きい)、
7 * 上限が閉じている (以下) ことを指定します。
8 * 例えば、(min, max] の範囲を意味します。
9 *
10 * この機能は PHP 8.2 以降で利用可能です。
11 */
12function generateRandomNumberWithOpenClosedBoundary(): void
13{
14    // PHP の新しい乱数生成器 Random\Randomizer をインスタンス化します。
15    // これは、安全で予測不可能な乱数生成を提供します。
16    $randomizer = new Random\Randomizer();
17
18    // 乱数生成の最小値と最大値を定義します。
19    $min = 1;
20    $max = 10;
21
22    // Random\IntervalBoundary::OpenClosed を使用して整数乱数を生成します。
23    // 生成される乱数は (1, 10] の範囲になります。
24    // つまり、「1 より大きく、10 以下」の整数（例: 2, 3, ..., 10）が生成されます。
25    $randomNumberInt = $randomizer->getInt($min, $max, Random\IntervalBoundary::OpenClosed);
26    echo "整数乱数 (範囲: ({$min}, {$max}]) : {$randomNumberInt}\n";
27
28    // Random\IntervalBoundary::OpenClosed を使用して浮動小数点数乱数も生成できます。
29    // 生成される乱数は (1.0, 10.0] の範囲になります。
30    // つまり、「1.0 より大きく、10.0 以下」の浮動小数点数（例: 1.000...001 から 10.0 まで）が生成されます。
31    $randomNumberFloat = $randomizer->getFloat($min, $max, Random\IntervalBoundary::OpenClosed);
32    echo "浮動小数点数乱数 (範囲: ({$min}, {$max}]) : {$randomNumberFloat}\n";
33}
34
35// 関数を呼び出して、サンプルコードを実行します。
36generateRandomNumberWithOpenClosedBoundary();
37

PHP 8.2以降で利用可能なRandom\IntervalBoundary::OpenClosed定数は、乱数生成の範囲の境界条件を厳密に指定するために使用されます。この定数自体に引数や戻り値はありませんが、PHPの新しい乱数生成器であるRandom\RandomizerクラスのgetIntやgetFloatといったメソッドの引数として渡すことで、生成される乱数の範囲を詳細に制御することが可能です。

具体的にOpenClosed定数を指定すると、乱数生成の範囲は「下限が開いており（より大きい）、上限が閉じている（以下）」という意味になります。これは数学的な表記で(min, max]と表され、「最小値より大きく、最大値以下」の乱数が生成されることを示します。

サンプルコードでは、まずRandom\Randomizerのインスタンスを生成し、安全な乱数を生成する準備をしています。次に、最小値1と最大値10を設定し、Random\IntervalBoundary::OpenClosed定数を用いて整数と浮動小数点数の乱数をそれぞれ生成しています。これにより、整数乱数の場合は2から10までの整数（1より大きく10以下）、浮動小数点数乱数の場合は1.0より大きく10.0以下の数値が生成されることになります。この定数は、特定の範囲ルールに沿った乱数が必要な場合に非常に有用です。

Copy
1<?php
2
3/**
4 * PHPの基本的なファイル操作（fopen, fwrite, fread, fclose）を示す関数。
5 * システムエンジニアを目指す初心者向けに、ファイルの書き込み、読み込み、そして閉じる一連の処理を簡潔に示します。
6 */
7function handleBasicFileOperations(): void
8{
9    // 一時ファイル名を生成します。
10    // sys_get_temp_dir() はシステムの一時ディレクトリのパスを返します。
11    $filePath = sys_get_temp_dir() . '/sample_data_' . uniqid() . '.txt';
12    $contentToWrite = "これはPHPファイル操作のサンプルデータです。\n新しい行に日本語のテキスト。\n";
13
14    echo "--- ファイル書き込み処理 ---\n";
15
16    // 1. ファイルを書き込みモード ('w') で開きます。
17    //    'w'モードは、ファイルが存在しない場合は作成し、存在する場合は内容を上書きします。
18    //    fopen() はファイルリソース（ファイルへのポインタ）または失敗時に false を返します。
19    $fileHandle = fopen($filePath, 'w');
20
21    if ($fileHandle === false) {
22        echo "エラー: ファイル '{$filePath}' を書き込み用に開けませんでした。\n";
23        return; // 処理を終了
24    }
25
26    echo "ファイル '{$filePath}' を書き込みモードで開きました。\n";
27
28    // 2. ファイルにデータを書き込みます。
29    //    fwrite() は書き込まれたバイト数を返します。
30    $bytesWritten = fwrite($fileHandle, $contentToWrite);
31
32    if ($bytesWritten === false) {
33        echo "エラー: ファイルへの書き込みに失敗しました。\n";
34    } else {
35        echo "ファイルに {$bytesWritten} バイト書き込みました。\n";
36    }
37
38    // 3. ファイルリソースを閉じます。
39    //    fclose() は成功時に true、失敗時に false を返します。
40    if (fclose($fileHandle)) {
41        echo "ファイル '{$filePath}' を閉じました。\n";
42    } else {
43        echo "エラー: ファイル '{$filePath}' を閉じることができませんでした。\n";
44    }
45
46    echo "\n--- ファイル読み込み処理 ---\n";
47
48    // 4. ファイルを読み込みモード ('r') で開きます。
49    //    'r'モードは、ファイルを読み込むために開きます。ファイルが存在しない場合はエラーになります。
50    $fileHandle = fopen($filePath, 'r');
51
52    if ($fileHandle === false) {
53        echo "エラー: ファイル '{$filePath}' を読み込み用に開けませんでした。\n";
54        return; // 処理を終了
55    }
56
57    echo "ファイル '{$filePath}' を読み込みモードで開きました。\n";
58
59    // 5. ファイルの内容をすべて読み込みます。
60    //    fread() はファイルから指定されたバイト数を読み込みます。
61    //    ここでは filesize() を使ってファイルの全サイズを指定し、全内容を読み込みます。
62    $readContent = fread($fileHandle, filesize($filePath));
63
64    if ($readContent === false) {
65        echo "エラー: ファイルからの読み込みに失敗しました。\n";
66    } else {
67        echo "ファイルの内容:\n";
68        echo "----------------------------------------\n";
69        echo $readContent;
70        echo "----------------------------------------\n";
71    }
72
73    // 6. ファイルリソースを閉じます。
74    if (fclose($fileHandle)) {
75        echo "ファイル '{$filePath}' を閉じました。\n";
76    } else {
77        echo "エラー: ファイル '{$filePath}' を閉じることができませんでした。\n";
78    }
79
80    echo "\n--- ファイルクリーンアップ ---\n";
81
82    // 7. 作成した一時ファイルを削除します。
83    //    unlink() はファイルシステムからファイルを削除します。
84    if (unlink($filePath)) {
85        echo "一時ファイル '{$filePath}' を削除しました。\n";
86    } else {
87        echo "エラー: 一時ファイル '{$filePath}' を削除できませんでした。\n";
88    }
89}
90
91// 上記で定義したファイル操作関数を実行します。
92handleBasicFileOperations();

このPHPコードは、ファイルに対する基本的な操作を学ぶためのものです。まず、sys_get_temp_dir()とuniqid()を使って一時ファイル名を生成し、そのファイルにデータを書き込み、読み込み、そして最後に削除する一連の流れを示しています。

ファイルを操作する際には、まずfopen()関数でファイルを開きます。この関数は、ファイルパスとモード（例: 'w'で書き込み、'r'で読み込み）を引数にとり、ファイルへのポインタ（ファイルリソース）を返します。ファイルを開くことに失敗した場合はfalseを返しますので、適切にエラーチェックを行うことが重要です。

次に、fwrite()関数を使って開いたファイルリソースに文字列データを書き込みます。この関数は書き込まれたバイト数を返し、失敗するとfalseを返します。読み込みたい場合は、fread()関数を使用します。ファイルリソースと読み込むバイト数を引数にとり、ファイルの内容を文字列として返します。ここではfilesize()を使ってファイルの全サイズを指定し、内容を全て読み込んでいます。

ファイル操作の完了後には、必ずfclose()関数を使ってファイルリソースを閉じます。これはシステムリソースを解放するために非常に重要で、成功するとtrueを、失敗するとfalseを返します。最後に、unlink()関数で一時ファイルを削除し、ディスクスペースをクリーンアップしています。unlink()はファイルの削除に成功するとtrueを、失敗するとfalseを返します。このように、各関数の戻り値を確認することで、エラーを適切に処理できます。