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

Copy
1<?php
2
3// 'posix' および 'pcntl' 拡張機能が有効になっているかを確認します。
4// これらの拡張機能は、プロセス管理とシグナル処理に必要です。
5if (!extension_loaded('posix') || !extension_loaded('pcntl')) {
6    echo "エラー: 'posix' および/または 'pcntl' 拡張機能が有効になっていません。\n";
7    echo "php.ini で有効にするか、インストールされているか確認してください。\n";
8    exit(1);
9}
10
11/**
12 * プロセス管理とPOSIXリソース制限のデモンストレーションを行います。
13 *
14 * この関数は、子プロセスを生成し、そのリソース制限情報を確認し、
15 * 親プロセスから子プロセスへシグナルを送信して終了させる一連の流れを示します。
16 */
17function demonstrateProcessControl(): void
18{
19    echo "--- 親プロセス開始 ---\n";
20    echo "親プロセスID: " . posix_getpid() . "\n";
21
22    // POSIX_RLIMIT_CPU 定数の使用例
23    // この定数は、プロセスが利用できるCPU時間のリソース制限を定義します。
24    // posix_getrlimit() 関数で現在のCPU時間制限を取得できます。
25    $cpuLimitInfo = posix_getrlimit(POSIX_RLIMIT_CPU);
26    if ($cpuLimitInfo !== false) {
27        echo "現在のCPU時間ソフトリミット (POSIX_RLIMIT_CPU): "
28             . (($cpuLimitInfo['softlimit'] === -1) ? "無制限" : $cpuLimitInfo['softlimit'] . "秒") . "\n";
29        echo "現在のCPU時間ハードリミット (POSIX_RLIMIT_CPU): "
30             . (($cpuLimitInfo['hardlimit'] === -1) ? "無制限" : $cpuLimitInfo['hardlimit'] . "秒") . "\n";
31    } else {
32        echo "警告: CPU時間リミットの取得に失敗しました。\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 === 0) {
44        // --- 子プロセスでの処理 ---
45        echo "--- 子プロセス開始 ---\n";
46        echo "子プロセスID: " . posix_getpid() . "\n";
47
48        // SIGTERM (終了シグナル) 用のシグナルハンドラを設定します。
49        // 親プロセスからSIGTERMを受信した際に、安全に終了するための処理です。
50        pcntl_signal(SIGTERM, function ($signo) {
51            echo "子プロセス (PID: " . posix_getpid() . "): SIGTERM ($signo) を受信。終了します。\n";
52            exit(0);
53        });
54
55        echo "子プロセス: 親プロセスからのシグナルを待機中 (最大10秒)...\n";
56        $startTime = time();
57        while (true) {
58            // 受信したシグナルを処理するために定期的に呼び出します。
59            pcntl_signal_dispatch();
60            if (time() - $startTime >= 10) {
61                // 親プロセスからシグナルが来ない場合、自分で終了します。
62                echo "子プロセス (PID: " . posix_getpid() . "): 10秒が経過。自己終了します。\n";
63                exit(0);
64            }
65            sleep(1); // 1秒待機
66        }
67    } else {
68        // --- 親プロセスでの処理 ---
69        echo "親プロセス: 子プロセスを生成しました (子PID: " . $pid . ")\n";
70        echo "親プロセス: 3秒間待機してから子プロセスに終了シグナルを送ります。\n";
71        sleep(3);
72
73        // posix_kill() を使用して子プロセスに SIGTERM シグナルを送信します。
74        // SIGTERM (シグナル番号 15) は、プロセスに終了を要求する標準的なシグナルです。
75        $success = posix_kill($pid, SIGTERM);
76
77        if ($success) {
78            echo "親プロセス: 子プロセス (PID: " . $pid . ") に SIGTERM を送信しました。\n";
79        } else {
80            echo "親プロセス: 子プロセス (PID: " . $pid . ") への SIGTERM 送信に失敗しました。エラー: " . posix_strerror(posix_get_last_error()) . "\n";
81        }
82
83        // 子プロセスの終了を待ち、そのステータスを取得します。
84        pcntl_wait($status);
85
86        if (pcntl_wifexited($status)) {
87            echo "親プロセス: 子プロセス (PID: " . $pid . ") が正常終了。ステータス: " . pcntl_wexitstatus($status) . "\n";
88        } elseif (pcntl_wifsignaled($status)) {
89            echo "親プロセス: 子プロセス (PID: " . $pid . ") がシグナル (" . pcntl_wtermsig($status) . ") により終了。\n";
90        } else {
91            echo "親プロセス: 子プロセス (PID: " . $pid . ") が不明な理由で終了しました。\n";
92        }
93        echo "--- 親プロセス終了 ---\n";
94    }
95}
96
97// 関数の実行
98demonstrateProcessControl();

このPHPコードは、プロセスを生成し、そのリソース制限を確認し、親プロセスから子プロセスへシグナルを送信して終了させる一連のプロセス管理の基本をデモンストレーションしています。まず、posixとpcntlというプロセス操作に必要な拡張機能が有効になっているかを確認しています。

POSIX_RLIMIT_CPU定数は、プロセスが利用できるCPU時間の制限を指定するための識別子です。この定数自体は整数値（int）を返し、サンプルコードではposix_getrlimit()関数と組み合わせて現在のCPU時間制限のソフトリミットとハードリミットを取得し、表示しています。

コードはpcntl_fork()で子プロセスを生成します。子プロセスはSIGTERM（終了シグナル）を受信した場合に安全に終了するためのシグナルハンドラを設定し、親プロセスからのシグナルを待機します。親プロセスは数秒待機した後、posix_kill()関数を使って子プロセスへSIGTERMシグナルを送信します。posix_kill()は第一引数に対象プロセスのID（PID）を、第二引数に送信するシグナル番号（SIGTERMは一般的に15番の整数値）をそれぞれ整数値（int）で受け取り、シグナル送信に成功すればtrue、失敗すればfalseを返します。子プロセスはシグナルを受信すると設定されたハンドラに従って終了し、親プロセスはpcntl_wait()で子プロセスの終了を待ち、その結果を表示して処理を終える流れです。

Copy
1<?php
2
3/**
4 * POSIX_RLIMIT_CPU 定数を使用して、現在のCPU時間リソース制限を取得し表示します。
5 *
6 * この関数は、システムエンジニアを目指す初心者向けに、
7 * POSIX_RLIMIT_CPU 定数が posix_getrlimit 関数でどのように使われるかを示します。
8 * POSIX 拡張が有効になっているシステムでのみ動作します。
9 */
10function displayCpuResourceLimit(): void
11{
12    echo "CPU時間リソース制限の取得を試行します...\n";
13
14    // POSIX 拡張がロードされているか確認します。
15    // posix_* 関数や POSIX_* 定数を使用するには、この拡張が必要です。
16    if (!extension_loaded('posix')) {
17        echo "エラー: POSIX 拡張がロードされていません。\n";
18        echo "php.ini で 'extension=posix' を有効にするか、PHPのコンパイル時に --enable-posix オプションを使用してください。\n";
19        return;
20    }
21
22    // posix_getrlimit 関数を使用して、指定されたリソース(POSIX_RLIMIT_CPU)の現在の制限を取得します。
23    // 戻り値は 'soft' (現在の制限) と 'hard' (最大制限) の2つの要素を持つ配列です。
24    $rlimit = posix_getrlimit(POSIX_RLIMIT_CPU);
25
26    if ($rlimit === false) {
27        echo "エラー: CPU時間リソース制限の取得に失敗しました。\n";
28        return;
29    }
30
31    echo "現在のCPU時間リソース制限:\n";
32    echo "  ソフトリミット (soft limit): " . formatRlimitValue($rlimit['soft']) . "\n";
33    echo "  ハードリミット (hard limit): " . formatRlimitValue($rlimit['hard']) . "\n";
34    echo "\n";
35    echo "補足:\n";
36    echo "  - ソフトリミットは、通常ユーザーが変更できる上限です。\n";
37    echo "  - ハードリミットは、rootユーザーのみが変更できる絶対的な上限です。\n";
38    echo "  - '-1' は「無制限」を意味します。\n";
39}
40
41/**
42 * リソース制限の値を人間が読める形式にフォーマットします。
43 *
44 * @param int $value リソース制限の値
45 * @return string フォーマットされた文字列
46 */
47function formatRlimitValue(int $value): string
48{
49    return ($value === -1) ? '無制限 (-1)' : (string)$value . ' 秒';
50}
51
52// スクリプトを実行してCPU時間リソース制限を表示します。
53displayCpuResourceLimit();
54
55?>

PHP 8のPOSIX_RLIMIT_CPUは、UNIX系システムにおけるプロセスが利用できるCPU時間のリソース制限を示す定数です。この定数は整数型（int）の値を持ち、引数は取りません。主にposix_getrlimitのようなPHPのPOSIX拡張の関数と組み合わせて使用され、システムのCPU時間に関するリミット情報を取得する際に利用されます。

提供されたサンプルコードでは、まずposix拡張がPHPにロードされているかを確認しています。これは、POSIX_RLIMIT_CPU定数や関連関数を使用する上で必須の準備です。次に、posix_getrlimit関数にPOSIX_RLIMIT_CPU定数を渡すことで、現在のCPU時間のリソース制限を取得しています。この関数は、現在の運用制限である「ソフトリミット」と、システムが許可する最大制限である「ハードリミット」を要素として含む配列を戻り値として返します。取得された値が-1の場合は「無制限」を意味し、それ以外は秒単位で制限が示されます。この定数を用いることで、PHPプログラムからシステムのプロセスリソース制限をプログラム的に把握し、管理する一助となります。