【PHP8.x】posix_getppid()関数の使い方

Copy
1<?php
2
3/**
4 * 現在のプロセスの実効ユーザーID (UID) からユーザー情報を取得し、表示します。
5 *
6 * システムエンジニアを目指す初心者向けに、POSIX拡張関数の基本的な使用法を
7 * 示し、Linux/Unixシステムにおけるユーザー情報取得の概念を理解する手助けとなります。
8 * この関数は、posix_geteuid() で現在のUIDを取得し、posix_getpwuid() でそのUIDに対応する
9 * ユーザーの詳細情報を取得して表示します。
10 */
11function displayCurrentProcessUserInfo(): void
12{
13    // POSIX拡張がPHPにロードされているかを確認します。
14    // POSIX関数を使用するには、この拡張が有効になっている必要があります。
15    if (!extension_loaded('posix')) {
16        echo "エラー: POSIX拡張がロードされていません。PHPの設定を確認してください。\n";
17        return;
18    }
19
20    // 現在のプロセスの実効ユーザーID (UID) を取得します。
21    // これは、スクリプトを実行しているユーザーのシステム上のIDです。
22    $uid = posix_geteuid();
23
24    // 取得したUIDを使って、ユーザーのパスワードエントリ情報（ユーザー名、ホームディレクトリなど）を
25    // システムから取得します。
26    // posix_getpwuid() は成功した場合、ユーザー情報を連想配列で返します。
27    // 失敗した場合は false を返します。
28    $userInfo = posix_getpwuid($uid);
29
30    // ユーザー情報の取得に失敗した場合のエラーハンドリング
31    if ($userInfo === false) {
32        echo "エラー: UID " . $uid . " に対応するユーザー情報を取得できませんでした。\n";
33        return;
34    }
35
36    // 取得したユーザー情報を整形して表示します。
37    // 'passwd' フィールドは通常、セキュリティ上の理由から表示しません。
38    echo "--- 現在のプロセスのユーザー情報 ---\n";
39    echo "UID (ユーザーID): " . $userInfo['uid'] . "\n";
40    echo "GID (プライマリグループID): " . $userInfo['gid'] . "\n";
41    echo "ユーザー名: " . $userInfo['name'] . "\n";
42    echo "ホームディレクトリ: " . $userInfo['dir'] . "\n";
43    echo "シェル: " . $userInfo['shell'] . "\n";
44    echo "コメント/GECOSフィールド: " . $userInfo['gecos'] . "\n";
45}
46
47// 関数を実行してユーザー情報を表示します。
48displayCurrentProcessUserInfo();
49

このPHPサンプルコードは、LinuxやUnix系のシステムにおいて、PHPプロセスが実行されている現在のユーザーの詳細情報を取得し表示する方法を示しています。まず、extension_loaded('posix')関数でPOSIX拡張がPHPにロードされているかを確認し、システム情報を扱うための準備をします。

次に、posix_geteuid()関数を利用して、現在のスクリプトを実行している実効ユーザーID（UID）を取得します。この関数は引数を持たず、現在のプロセスのUIDを整数値で返します。

取得したUIDは、posix_getpwuid()関数の引数として渡されます。posix_getpwuid()は、指定されたUIDに対応するユーザーのパスワードエントリ情報（ユーザー名、ホームディレクトリ、シェルなど）をシステムから取得し、連想配列として返します。もし該当するユーザー情報が見つからない場合や取得に失敗した場合は、falseが戻り値となります。

サンプルコードでは、posix_getpwuid()の戻り値がfalseでないことを確認し、エラーハンドリングを行っています。最後に、取得した連想配列からuid、gid、name、dir、shell、gecosといったキーに対応するユーザー情報を整形して画面に出力しています。この一連の流れは、PHPからOSレベルのユーザー情報をプログラム的に扱うための基礎的な手法を学ぶ上で役立ちます。

Copy
1<?php
2
3/**
4 * このスクリプトの現在のプロセスIDと親プロセスIDを取得し、表示します。
5 * posix_getpid() は現在のプロセスのID (PID) を返します。
6 * posix_getppid() は親プロセスのID (PPID) を返します。
7 * これらの関数はPOSIX互換システム（Linux, macOSなど）で利用可能です。
8 */
9function displayProcessIds(): void
10{
11    // posix_getpid() および posix_getppid() 関数が利用可能か確認します。
12    // PHPの'posix'拡張機能が有効でない場合、これらの関数は存在しません。
13    if (function_exists('posix_getpid') && function_exists('posix_getppid')) {
14        // 現在のプロセスのIDを取得します。
15        $currentPid = posix_getpid();
16
17        // 親プロセスのIDを取得します。
18        $parentPid = posix_getppid();
19
20        echo "現在のプロセスID: " . $currentPid . PHP_EOL;
21        echo "親プロセスID: " . $parentPid . PHP_EOL;
22    } else {
23        echo "エラー: POSIX関数 (posix_getpid, posix_getppid) はこのシステムでは利用できません。" . PHP_EOL;
24        echo "PHPの'posix'拡張機能が有効になっているか確認してください。" . PHP_EOL;
25    }
26}
27
28// 関数を実行してプロセスIDを表示します。
29displayProcessIds();
30
31?>

このPHPスクリプトは、実行中のプログラム自身のID（プロセスID）と、そのプログラムを起動した親プログラムのID（親プロセスID）を表示する方法を示しています。システムエンジニアにとって、プログラムがどのように動作しているかを把握する上で重要な情報です。

posix_getpid()関数は、現在のPHPスクリプトが持つプロセスIDを整数値（int）で返します。これは、実行中のスクリプトを一意に識別するための番号です。

一方、今回焦点を当てるposix_getppid()関数は、引数を取らず、現在のスクリプトを起動した親プロセスのIDを整数値（int）で返します。例えば、ターミナルからPHPスクリプトを実行した場合、ターミナルのシェルが親プロセスとなります。この親プロセスIDを知ることで、プログラムがどのような経緯で実行されたかを追跡することが可能になります。

これらのposix関連関数は、LinuxやmacOSなどのPOSIX互換システムで利用できます。また、PHPのposix拡張機能が有効になっている必要があります。サンプルコードでは、function_existsを使ってこれらの関数が利用可能かを確認し、利用できる場合にプロセスIDと親プロセスIDを取得して画面に表示します。もし利用できない場合は、拡張機能の有効化を促すメッセージを出力します。システム管理や、複数のプログラムが連携して動作する環境で、プロセスの状態を把握するためにこれらの関数は役立ちます。