【PHP8.x】POSIX_RLIMIT_NICE定数の使い方

Copy
1<?php
2
3/**
4 * プロセスをフォークし、子プロセスをposix_killで終了させるサンプル関数。
5 *
6 * システムエンジニアを目指す初心者向けに、PHPでプロセス制御を行う基本を示します。
7 * POSIX_RLIMIT_NICEはプロセスのnice値（優先度）に関するリソース制限定数ですが、
8 * このサンプルではposix_killの動作を示すために、その存在と値を出力します。
9 *
10 * 注意: このスクリプトはUNIX系システムで実行し、PHPのpcntlおよびposix拡張が
11 * 有効になっている必要があります。ウェブサーバー環境では意図しない動作を
12 * 引き起こす可能性があるため、コマンドライン (CLI) から実行してください。
13 */
14function manageProcessWithKill(): void
15{
16    echo "--- プロセス管理の開始 ---\n";
17
18    // 現在のプロセスのPIDを表示 (親プロセス)
19    $parentPid = posix_getpid();
20    echo "親プロセスのPID: " . $parentPid . "\n";
21
22    // 子プロセスをフォーク (生成)
23    $pid = pcntl_fork();
24
25    if ($pid === -1) {
26        // フォークに失敗した場合
27        die("エラー: 子プロセスのフォークに失敗しました。\n");
28    } elseif ($pid) {
29        // 親プロセスの場合
30        echo "子プロセス (PID: " . $pid . ") を生成しました。\n";
31        echo "3秒間待機してから、子プロセスに終了シグナルを送ります...\n";
32        sleep(3);
33
34        // 子プロセスにSIGTERM (終了シグナル) を送信
35        // posix_kill() は指定されたPIDにシグナルを送信します。
36        // SIGTERM (通常15) は、プロセスに優雅な終了を要求するシグナルです。
37        if (posix_kill($pid, SIGTERM)) {
38            echo "子プロセス (PID: " . $pid . ") にSIGTERMシグナルを送信しました。\n";
39        } else {
40            echo "エラー: 子プロセス (PID: " . $pid . ") へのSIGTERMシグナル送信に失敗しました。\n";
41        }
42
43        // 子プロセスの終了を待機
44        pcntl_waitpid($pid, $status);
45        echo "子プロセス (PID: " . $pid . ") が終了しました。\n";
46
47        // POSIX_RLIMIT_NICE 定数の値を出力
48        // この定数はプロセスのnice値（優先度）に関連するリソース制限を指定します。
49        // posix_killの直接の引数ではありませんが、POSIX環境でのプロセス管理に関連する定数です。
50        if (defined('POSIX_RLIMIT_NICE')) {
51            echo "POSIX_RLIMIT_NICE の値: " . POSIX_RLIMIT_NICE . " (これはnice値のリソース制限を示す定数です)\n";
52        } else {
53            echo "POSIX_RLIMIT_NICE は定義されていません (PHPのPOSIX拡張が完全に有効か確認してください)。\n";
54        }
55    } else {
56        // 子プロセスの場合
57        $childPid = posix_getpid();
58        echo "子プロセス (PID: " . $childPid . ") が起動しました。\n";
59        echo "子プロセス (PID: " . $childPid . ") は無限ループで実行中... (SIGTERMを待機)\n";
60
61        // シグナルハンドラを設定 (SIGTERMを捕捉して終了するように)
62        // pcntl_signal() は指定されたシグナルを受信した際のコールバック関数を設定します。
63        pcntl_signal(SIGTERM, function ($signal) use ($childPid) {
64            echo "子プロセス (PID: " . $childPid . ") がSIGTERMシグナルを受け取りました。終了します。\n";
65            exit(0); // 正常終了
66        });
67
68        // 無限ループでシグナルを待機
69        // pcntl_signal_dispatch() は、保留中のシグナルハンドラを呼び出します。
70        // シグナルは非同期で発生しますが、実際にハンドラが実行されるのは dispatch のタイミングです。
71        while (true) {
72            pcntl_signal_dispatch();
73            sleep(1); // CPU使用率を抑えるために少し待機
74        }
75    }
76
77    echo "--- プロセス管理の終了 ---\n";
78}
79
80// 関数を実行
81manageProcessWithKill();

このPHPサンプルコードは、UNIX系システムにおけるプロセスの生成と終了、そしてposix_kill関数を用いたシグナル送信の基本をシステムエンジニアを目指す初心者の方向けに示しています。

まず、pcntl_fork()関数により親プロセスから子プロセスを生成します。親プロセスは、生成した子プロセスに対してposix_kill関数でSIGTERMシグナルを送信し、終了を要求します。posix_kill関数は、第一引数にプロセスID（int）、第二引数に送信するシグナル番号（int）を指定することで、対象プロセスにシグナルを送る役割を持ちます。SIGTERMは、プロセスに優雅な終了を促す標準的なシグナルです。この関数は、シグナルの送信に成功した場合にtrueを、失敗した場合はfalseを返します。

子プロセス側では、pcntl_signal()関数を使用してSIGTERMシグナルを受け取った際にプロセスを終了するハンドラを設定しています。これにより、親プロセスからの終了要求に応じて子プロセスが安全に終了します。

また、コード中ではPOSIX_RLIMIT_NICE定数の値も出力しています。これは、プロセスの優先度（nice値）に関するリソース制限を示す定数であり、その値は整数（int）です。posix_kill関数の直接の引数ではありませんが、POSIX環境でのプロセス管理に関連する情報として参照されます。

このスクリプトは、PHPのpcntlおよびposix拡張が有効なUNIX系システム上で、コマンドライン（CLI）から実行する必要があります。

Copy
1<?php
2
3/**
4 * POSIX_RLIMIT_NICE 定数の値と、それに関連する現在のシステムリソース制限を表示します。
5 *
6 * この定数は、システムリソース制限を設定・取得するための関数 (setrlimit() や getrlimit()) で、
7 * プロセスの「nice」値（優先度）に関する制限を指定するために使用される識別子です。
8 * システムエンジニアを目指す初心者向けに、この定数がどのように使われるか、
9 * またその値が何であるかを示します。
10 *
11 * @return void
12 */
13function demonstratePosixRlimitNice(): void
14{
15    // POSIX 拡張機能がロードされているかを確認します。
16    // この拡張機能は通常、Unix系OSでのみ利用可能です。
17    if (!extension_loaded('posix')) {
18        echo "エラー: POSIX 拡張機能がロードされていません。\n";
19        echo "このスクリプトはUnix系のOSでPHPを実行した場合にのみ動作します。\n";
20        return;
21    }
22
23    // POSIX_RLIMIT_NICE 定数の値を出力します。
24    // この定数自体は、'nice' 値のリソース制限を識別するための単なる整数値です。
25    echo "POSIX_RLIMIT_NICE の値: " . POSIX_RLIMIT_NICE . "\n";
26
27    // posix_getrlimit() 関数を使用して、現在の 'nice' 値のリソース制限を取得します。
28    // この関数は、指定されたリソース (POSIX_RLIMIT_NICE) の
29    // 現在のソフトリミットとハードリミットを含む配列を返します。
30    $rlimit = posix_getrlimit(POSIX_RLIMIT_NICE);
31
32    if ($rlimit === false) {
33        echo "エラー: nice 値のリソース制限の取得に失敗しました。\n";
34    } else {
35        echo "現在の 'nice' 値のリソース制限:\n";
36        // ソフトリミットは、一般ユーザーが設定できる最大値です。
37        echo "  ソフトリミット: " . ($rlimit['soft'] === -1 ? '無制限' : $rlimit['soft']) . "\n";
38        // ハードリミットは、rootユーザーでも超えられない絶対的な最大値です。
39        echo "  ハードリミット: " . ($rlimit['hard'] === -1 ? '無制限' : $rlimit['hard']) . "\n";
40        echo "  ※ 'nice' 値はプロセスの優先度を示し、低い値ほど優先度が高くなります。\n";
41        echo "     この制限は、プロセスがどれだけ低い (つまり高い優先度の) 'nice' 値を設定できるかを制御します。\n";
42    }
43}
44
45// 関数を実行して、POSIX_RLIMIT_NICE の情報を表示します。
46demonstratePosixRlimitNice();
47

POSIX_RLIMIT_NICEは、PHPのPOSIX拡張機能によって提供される定数です。この定数は、システムリソース制限を設定したり取得したりするための関数（例：posix_getrlimit()やposix_setrlimit()）において、プロセスの「nice」値に関する制限を識別するために使われる特別な整数値です。

この定数自体は引数を取りません。その戻り値は、内部でこの特定のリソース（nice値の制限）を識別するための整数値です。

サンプルコードでは、まずPOSIX_RLIMIT_NICE定数自身の値を出力し、次にposix_getrlimit()関数と組み合わせて、現在の「nice」値に対するリソース制限（ソフトリミットとハードリミット）を取得し、表示しています。ここでいう「nice」値はプロセスの優先度を示し、値が低いほど優先度が高くなります。このリソース制限は、プロセスがどれだけ低い（つまり、高優先度の）「nice」値を設定できるかを制御することで、システム全体のリソース利用の公平性や安定性を保つ重要な役割を担っています。この機能は主にUnix系のOS環境で利用されます。