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

Copy
1<?php
2
3/**
4 * POSIX_PC_LINK_MAX 定数の値を出力する関数。
5 *
6 * この定数は、システムがサポートするファイルのハードリンクの最大数を
7 * 取得するための識別子として、PHP の POSIX 拡張機能の pathconf() 関数などで使用されます。
8 *
9 * システムエンジニアを目指す初心者の方へ:
10 * 定数は、プログラム実行中に変更されない固定の値を保持する名前付きの場所です。
11 * POSIX_PC_LINK_MAX のような定数は、オペレーティングシステムに関連する
12 * 特定の設定値や動作モードをプログラムから参照・利用するために定義されます。
13 *
14 * @return void
15 */
16function displayPosixLinkMaxConstant(): void
17{
18    // POSIX 拡張が利用可能か確認します。
19    // この定数は POSIX 拡張の一部であるため、拡張がロードされている必要があります。
20    if (extension_loaded('posix')) {
21        // POSIX_PC_LINK_MAX 定数の値を出力します。
22        // この値は、pathconf() 関数などに渡す際に使用される内部的な識別子です。
23        echo "POSIX_PC_LINK_MAX 定数の値: " . POSIX_PC_LINK_MAX . PHP_EOL;
24    } else {
25        echo "警告: PHP の POSIX 拡張がロードされていません。" . PHP_EOL;
26        echo "この定数は利用できません。php.ini で 'extension=posix' を有効にする必要があるかもしれません。" . PHP_EOL;
27    }
28}
29
30// 関数を実行して、定数の値を出力します。
31displayPosixLinkMaxConstant();

PHP 8 の POSIX_PC_LINK_MAX は、POSIX 拡張機能が提供する定数です。この定数は、オペレーティングシステムがサポートするファイルのハードリンクの最大数を取得するための識別子として使用されます。具体的には、PHP の pathconf() 関数などの POSIX 関連関数に渡すことで、システムの特定の設定値や制限を参照するために利用されるものです。

システムエンジニアを目指す初心者の方にとって、定数とはプログラムの実行中にその値が変更されることのない、固定の値を持つ名前付きの場所を指します。POSIX_PC_LINK_MAX のような定数は、基盤となるオペレーティングシステムが持つ動作に関する設定や制限を、PHP プログラムから安全に参照するために定義されています。

提示されたサンプルコードでは、まず extension_loaded('posix') 関数を使用して、PHP の POSIX 拡張が有効になっているかを確認しています。これは、POSIX_PC_LINK_MAX 定数が POSIX 拡張の一部であるため、拡張がロードされていなければこの定数を利用できないためです。拡張が有効な場合にのみ、echo 文を用いて POSIX_PC_LINK_MAX 定数に格納されている値を画面に出力しています。この定数自体は引数を取りませんし、直接的な戻り値もありませんが、その値はシステムの情報を得るための重要な識別子として機能します。拡張がロードされていない場合は、利用できない旨の警告が表示されるようになっています。

Copy
1<?php
2
3/**
4 * posix_kill 関数の基本的な使い方を示すサンプルスクリプトです。
5 * このスクリプトは親プロセスが子プロセスを生成し、その後子プロセスに終了シグナル (SIGTERM) を送ります。
6 * UNIX系システムで動作します。Windows環境では動作しません。
7 *
8 * @param int $childWaitSeconds 親プロセスが子プロセスにシグナルを送るまでの待機時間（秒）
9 * @return void
10 */
11function demonstratePosixKill(int $childWaitSeconds = 3): void
12{
13    // POSIX拡張がロードされているかを確認
14    if (!extension_loaded('posix')) {
15        echo "エラー: POSIX拡張がロードされていません。このスクリプトはUNIX系システムでのみ動作します。\n";
16        return;
17    }
18
19    // PCNTL拡張がロードされているかを確認 (プロセスフォークに必要)
20    if (!extension_loaded('pcntl')) {
21        echo "エラー: PCNTL拡張がロードされていません。このスクリプトはUNIX系システムでのみ動作します。\n";
22        return;
23    }
24
25    // SIGTERM (終了シグナル) のシグナルハンドラを設定します。
26    // 子プロセスがSIGTERMを受け取った際に実行されるコールバック関数です。
27    pcntl_signal(SIGTERM, function ($signal) {
28        echo "子プロセス " . posix_getpid() . ": SIGTERMシグナルを受け取りました。終了します。\n";
29        exit(0); // シグナルを受け取ったら子プロセスを正常終了
30    });
31
32    echo "親プロセス " . posix_getpid() . ": 開始しました。\n";
33
34    // プロセスをフォークして子プロセスを生成
35    $pid = pcntl_fork();
36
37    if ($pid === -1) {
38        // フォーク失敗時
39        echo "エラー: プロセスフォークに失敗しました。\n";
40        exit(1); // スクリプトをエラー終了
41    } elseif ($pid) {
42        // 親プロセス側の処理
43        echo "親プロセス " . posix_getpid() . ": 子プロセス (PID: " . $pid . ") を生成しました。\n";
44        echo "親プロセス " . posix_getpid() . ": {$childWaitSeconds}秒待機後、子プロセスにSIGTERMを送ります。\n";
45        sleep($childWaitSeconds); // 子プロセスが動作するのを待つ
46
47        // posix_kill() を使用して子プロセスにSIGTERMシグナルを送信
48        // SIGTERM (シグナル番号 15) は、プロセスに優雅な終了を要求するシグナルです。
49        $success = posix_kill($pid, SIGTERM);
50
51        if ($success) {
52            echo "親プロセス " . posix_getpid() . ": 子プロセス " . $pid . " にSIGTERMシグナルを正常に送信しました。\n";
53        } else {
54            echo "親プロセス " . posix_getpid() . ": 子プロセス " . $pid . " へのSIGTERMシグナル送信に失敗しました。\n";
55        }
56
57        // 子プロセスの終了を待機し、ゾンビプロセスになるのを防ぐ
58        pcntl_waitpid($pid, $status);
59        echo "親プロセス " . posix_getpid() . ": 子プロセス " . $pid . " が終了しました。\n";
60
61    } else {
62        // 子プロセス側の処理
63        echo "子プロセス " . posix_getpid() . ": 開始しました。親からのシグナルを待っています。\n";
64        // シグナルを処理するために無限ループで待機
65        // pcntl_signal_dispatch() を定期的に呼び出すことで、
66        // 登録されたシグナルハンドラが実行される機会を与えます。
67        while (true) {
68            pcntl_signal_dispatch(); // シグナルをディスパッチ
69            echo "子プロセス " . posix_getpid() . ": 動作中...\n";
70            sleep(1); // CPU負荷を減らすために1秒待機
71        }
72    }
73
74    echo "プロセス " . posix_getpid() . ": 終了します。\n";
75}
76
77// スクリプトの実行
78demonstratePosixKill(3);

このサンプルコードは、PHPでposix_kill関数を利用して、特定のプロセスへシグナルを送信する基本的な手順を示しています。この機能はUNIX系システムで利用可能であり、Windows環境では動作しません。

スクリプトでは、まず親プロセスがpcntl_fork()関数を用いて子プロセスを生成します。子プロセスは起動後、親プロセスからのシグナルを待機します。親プロセスは指定された時間待機した後、posix_kill()関数を呼び出し、生成した子プロセスに対してSIGTERM（終了シグナル）を送信します。

posix_kill()関数は、第1引数にシグナルを送信したいプロセスのID（PID）を、第2引数に送信するシグナル番号（例えばSIGTERMはプログラムの終了を要求するシグナル）を指定します。この関数は、シグナルの送信が成功した場合はtrueを、失敗した場合はfalseを戻り値として返します。子プロセスはSIGTERMを受け取ると、事前に設定されたシグナルハンドラによって適切に終了し、親プロセスは子プロセスの終了を待機してから自身の処理を完了します。これにより、posix_killがプロセスを制御する仕組みを理解できます。