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

Copy
1<?php
2
3/**
4 * プロセスをフォークし、親プロセスから子プロセスに終了シグナルを送るサンプルコード。
5 * また、現在のプロセスのリソース制限情報（特にプロセス数制限）も表示します。
6 *
7 * このスクリプトはUNIX系システムで動作します。
8 * PHPのpcntlおよびposix拡張機能が有効になっている必要があります。
9 */
10function demonstratePosixProcessManagement(): void
11{
12    // pcntl拡張とposix拡張がロードされているかを確認
13    if (!extension_loaded('pcntl') || !extension_loaded('posix')) {
14        echo "エラー: pcntl および posix 拡張機能がロードされていません。\n";
15        echo "これらの拡張機能はUNIX系OSでのみ利用可能です。php.iniで有効にしてください。\n";
16        return;
17    }
18
19    echo "--- プロセス管理デモンストレーション開始 ---\n";
20
21    // プロセス数制限のリソース情報を取得
22    // POSIX_RLIMIT_NPROC は、ユーザーが同時に実行できるプロセスの最大数を制限する定数です。
23    // この定数は posix_getrlimit() の返り値のキーとして使用され、プロセス数の制限値を示します。
24    $rlimit = posix_getrlimit();
25    if ($rlimit === false) {
26        echo "エラー: posix_getrlimit() の取得に失敗しました。\n";
27    } else {
28        echo "現在のプロセス数制限 (POSIX_RLIMIT_NPROC):\n";
29        // 'soft' はソフトリミット、'hard' はハードリミットを示します。
30        // -1 は「無制限」を意味します。
31        echo "  ソフトリミット (soft limit): " . ($rlimit[POSIX_RLIMIT_NPROC]['soft'] == -1 ? '無制限' : $rlimit[POSIX_RLIMIT_NPROC]['soft']) . "\n";
32        echo "  ハードリミット (hard limit): " . ($rlimit[POSIX_RLIMIT_NPROC]['hard'] == -1 ? '無制限' : $rlimit[POSIX_RLIMIT_NPROC]['hard']) . "\n";
33    }
34    echo "----------------------------------------\n";
35
36    // 子プロセスをフォーク（複製）します
37    $pid = pcntl_fork();
38
39    if ($pid === -1) {
40        // フォーク失敗
41        echo "エラー: プロセスのフォークに失敗しました。\n";
42        exit(1);
43    } elseif ($pid) {
44        // 親プロセス側の処理 (PIDは子プロセスのID)
45        $parentPid = posix_getpid();
46        echo "親プロセス (PID: {$parentPid}) が子プロセス (PID: {$pid}) を生成しました。\n";
47
48        echo "親プロセスは5秒間待機してから子プロセスにシグナルを送ります。\n";
49        sleep(5);
50
51        echo "親プロセスは子プロセス (PID: {$pid}) に終了シグナル (SIGTERM) を送ります。\n";
52        // posix_kill() を使って子プロセスに終了シグナル (SIGTERM, シグナル番号15) を送信します。
53        // SIGTERM は、プロセスに対して「優雅に終了してください」と要求する標準的なシグナルです。
54        $killResult = posix_kill($pid, SIGTERM);
55
56        if ($killResult) {
57            echo "終了シグナル (SIGTERM) が子プロセスに正常に送信されました。\n";
58        } else {
59            echo "エラー: 子プロセス (PID: {$pid}) へのシグナル送信に失敗しました。\n";
60        }
61
62        // 子プロセスの終了を待機し、ゾンビプロセスになるのを防ぎます
63        pcntl_waitpid($pid, $status);
64        echo "子プロセス (PID: {$pid}) が終了しました。\n";
65        echo "--- プロセス管理デモンストレーション終了 ---\n";
66    } else {
67        // 子プロセス側の処理 (PIDは自身のID)
68        $childPid = posix_getpid();
69        echo "子プロセス (PID: {$childPid}) が開始しました。親プロセスからのシグナルを待機しています。\n";
70
71        // シグナルハンドラを設定
72        // SIGTERM を受け取ったら、メッセージを表示して正常終了します。
73        pcntl_signal(SIGTERM, function ($signo) use ($childPid) {
74            echo "子プロセス (PID: {$childPid}) がシグナル {$signo} (SIGTERM) を受け取りました。正常終了します。\n";
75            exit(0);
76        });
77
78        // 無限ループで処理を継続し、シグナルを待機します。
79        // pcntl_signal_dispatch() を定期的に呼び出し、保留中のシグナルを処理する機会を与えます。
80        while (true) {
81            echo "子プロセス (PID: {$childPid}) は作業中です...\n";
82            sleep(2); // 2秒ごとに作業をシミュレート
83            pcntl_signal_dispatch(); // シグナルハンドラが実行されるようにします
84        }
85    }
86}
87
88// 関数を実行します
89demonstratePosixProcessManagement();
90

PHPのこのサンプルコードは、UNIX系OSにおけるプロセス管理の基礎をシステムエンジニアを目指す初心者向けに分かりやすく解説しています。まず、posix_getrlimit()関数を利用し、ユーザーが同時に実行できるプロセスの最大数を制限するPOSIX_RLIMIT_NPROC定数で示されるリソース制限情報を表示します。POSIX_RLIMIT_NPROCは整数型の定数であり、リソースの種類を識別するキーとして機能します。

続いて、pcntl_fork()関数を用いて現在のプロセスを複製し、親プロセスと子プロセスを生成します。親プロセスは、しばらく待機した後にposix_kill()関数を使用して子プロセスに終了シグナル（SIGTERM）を送信します。posix_kill()関数は第一引数にシグナルを送信するターゲットプロセスのPID、第二引数に送信するシグナル番号を指定し、成功した場合はtrueを、失敗した場合はfalseをブール値として返します。SIGTERMはプロセスに安全な終了を促す標準的なシグナルです。

子プロセスは、親プロセスからSIGTERMシグナルを受信すると、事前に設定されたシグナルハンドラによりメッセージを表示して正常に終了します。この一連の動作により、親プロセスが子プロセスの起動と終了を制御する基本的なメカニズムを示しています。このスクリプトはPHPのpcntlおよびposix拡張機能が有効になっている環境で動作します。

Copy
1<?php
2
3/**
4 * POSIX_RLIMIT_NPROC 定数とその関連リソース制限の情報を表示します。
5 *
6 * システムエンジニアを目指す初心者向けに、
7 * ユーザーが作成できるプロセス数の制限情報を取得する方法を示します。
8 *
9 * POSIX_RLIMIT_NPROC は、posix_getrlimit() や posix_setrlimit() などの関数で、
10 * プロセス数の制限を指定するために使用される定数です。
11 */
12function displayPosixNprocLimitInfo(): void
13{
14    // POSIX_RLIMIT_NPROC 定数の値（リソース種別を示す整数）を表示します。
15    // この定数自体は、リソース制限の種類を識別するためのIDです。
16    echo "POSIX_RLIMIT_NPROC 定数の値: " . POSIX_RLIMIT_NPROC . PHP_EOL;
17
18    // posix_getrlimit 関数を使って、POSIX_RLIMIT_NPROC で指定される
19    // プロセス数に関する現在のソフトリミットとハードリミットを取得します。
20    // この関数は、PHP の POSIX 拡張が有効な環境でのみ動作します。
21    $rlimitInfo = posix_getrlimit(POSIX_RLIMIT_NPROC);
22
23    if ($rlimitInfo !== false) {
24        echo "現在のプロセス数制限:" . PHP_EOL;
25        // softlimit: ユーザーが設定できるリソースの上限値。これを超えると通常エラーが発生します。
26        echo "  ソフトリミット (softlimit): " . $rlimitInfo['softlimit'] . PHP_EOL;
27        // hardlimit: ソフトリミットが超えることのできない絶対的な上限値。通常、rootユーザーのみ変更可能です。
28        echo "  ハードリミット (hardlimit): " . $rlimitInfo['hardlimit'] . PHP_EOL;
29    } else {
30        echo "エラー: POSIX 拡張が有効でないか、プロセス数制限の取得に失敗しました。" . PHP_EOL;
31        echo "PHP の設定で 'posix' 拡張が有効になっていることを確認してください。" . PHP_EOL;
32    }
33}
34
35// 定数と関連情報の表示関数を実行します。
36displayPosixNprocLimitInfo();
37
38?>

POSIX_RLIMIT_NPROCは、PHPのPOSIX拡張機能で利用される定数です。この定数は、オペレーティングシステムがユーザーに対して許可する「プロセス数」という特定のリソース制限を識別するために使用されます。その値は整数であり、直接的なリソース量を示すのではなく、どの種類のリソースに関する制限かを指定するためのIDとして機能します。

例えば、この定数はposix_getrlimit()関数の引数として渡すことで、現在のプロセス数に関する制限情報を取得できます。posix_getrlimit()は、引数として指定されたリソース（この場合はプロセス数）の現在の「ソフトリミット」と「ハードリミット」を連想配列として返します。ソフトリミットはユーザーが通常設定できる上限値で、これを超えるとエラーとなることが一般的です。一方、ハードリミットはソフトリミットが超えることのできない絶対的な上限値であり、通常はroot権限を持つユーザーのみが変更可能です。この関数は、PHPのPOSIX拡張が有効な環境でのみ動作します。

サンプルコードでは、まずPOSIX_RLIMIT_NPROC定数自体の値を出力し、次にposix_getrlimit()関数を使って現在のプロセス数のソフトリミットとハードリミットを取得し、その情報を表示しています。これにより、システムがユーザーに許可しているプロセス数の上限を初心者の方でも確認できます。