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

Copy
1<?php
2
3// このスクリプトはPHPのPOSIX拡張を利用します。
4// POSIX拡張は、UNIX系システムの情報にアクセスするための関数を提供します。
5// Windows環境など、POSIX拡張が利用できない場合はエラーとなります。
6if (!extension_loaded('posix')) {
7    echo "エラー: POSIX拡張がロードされていません。" . PHP_EOL;
8    echo "このスクリプトはUNIX系システムで動作するように設計されています。" . PHP_EOL;
9    exit(1);
10}
11
12// posix_getegid() 関数は、現在のプロセスの実効グループID (Effective Group ID) を整数値で取得します。
13// 実効グループIDは、プロセスがファイルやその他のリソースにアクセスする際のグループ権限を示します。
14$effectiveGroupId = posix_getegid();
15
16// 取得した実効グループIDを表示します。
17echo "現在のプロセスの実効グループID (EGID): " . $effectiveGroupId . PHP_EOL;
18
19// 参考: キーワードに関連するposix_geteuid() 関数も同様に実効ユーザーID (Effective User ID) を取得します。
20$effectiveUserId = posix_geteuid();
21echo "現在のプロセスの実効ユーザーID (EUID): " . $effectiveUserId . PHP_EOL;
22
23?>

PHPのPOSIX拡張は、UNIX系システムの情報にアクセスするための機能を提供します。posix_getegid()関数は、現在のPHPプロセスの実効グループID（Effective Group ID）を整数値で取得します。この実効グループIDは、プロセスがファイルやシステムリソースにアクセスする際のグループ権限を示します。この関数は引数を取らず、実行されたプロセスの実効グループIDを整数値として返します。

サンプルコードでは、まずextension_loaded('posix')でPOSIX拡張が利用可能かを確認しています。これは、UNIX系システム以外ではこの拡張が利用できないため、エラーを避けるための重要なステップです。その後、posix_getegid()を呼び出して実効グループIDを取得し、その結果を画面に出力しています。参考として、キーワードにあるposix_geteuid()関数も紹介されており、こちらは実効ユーザーID（Effective User ID）を取得する際に使用します。これらのPOSIX関連関数は、UNIX系システムにおけるプロセス権限やセキュリティ管理の理解に役立ちます。

Copy
1<?php
2
3// POSIX拡張機能が利用可能か確認します。
4// posix_* 関数を使用するには、PHPにPOSIX拡張機能がロードされている必要があります。
5if (!extension_loaded('posix')) {
6    echo "エラー: POSIX拡張機能がロードされていません。\n";
7    echo "PHPの設定ファイル (php.ini) で 'extension=posix' を有効にするか、\n";
8    echo "システムにPHPのPOSIX拡張をインストールしてください。\n";
9    exit(1);
10}
11
12// 1. 現在のスクリプトを実行しているユーザーの実効グループID (Effective Group ID) を取得します。
13// 実効グループIDは、プロセスがどのグループの権限で動作しているかを示します。
14$effectiveGroupId = posix_getegid();
15
16// 取得した実効グループIDを表示します。
17echo "現在のスクリプトの実効グループID (EGID): " . $effectiveGroupId . "\n";
18
19// 2. 取得したEGIDに対応するグループ情報を取得します。
20// これにより、IDだけでなくグループ名も確認できます。
21$groupInfo = posix_getgrgid($effectiveGroupId);
22if ($groupInfo !== false) {
23    echo "EGIDに紐づくグループ名: " . $groupInfo['name'] . "\n";
24} else {
25    echo "EGID (" . $effectiveGroupId . ") に紐づくグループ情報を取得できませんでした。\n";
26}
27
28echo "\n"; // 出力の区切り
29
30// 3. キーワード 'posix_getpwuid' に関連する機能として、現在の実行ユーザー情報を表示します。
31// まず、現在のスクリプトを実行しているユーザーの実効ユーザーID (Effective User ID) を取得します。
32$effectiveUserId = posix_getuid();
33
34// 取得した実効ユーザーIDを表示します。
35echo "現在のスクリプトの実効ユーザーID (EUID): " . $effectiveUserId . "\n";
36
37// 4. 実効ユーザーID (EUID) を使って、そのユーザーの詳細情報を取得します。
38// posix_getpwuid() は、ユーザーIDに対応するユーザー情報（ユーザー名、ホームディレクトリ、シェルなど）
39// を連想配列で返します。
40$userInfo = posix_getpwuid($effectiveUserId);
41
42if ($userInfo !== false) {
43    echo "EUIDに紐づくユーザー情報:\n";
44    echo "  ユーザー名: " . $userInfo['name'] . "\n";
45    echo "  パスワードフィールド (通常は'x'): " . $userInfo['passwd'] . "\n";
46    echo "  ユーザーID (UID): " . $userInfo['uid'] . "\n";
47    echo "  プライマリグループID (GID): " . $userInfo['gid'] . "\n";
48    echo "  ユーザー情報コメント: " . $userInfo['gecos'] . "\n";
49    echo "  ホームディレクトリ: " . $userInfo['dir'] . "\n";
50    echo "  デフォルトシェル: " . $userInfo['shell'] . "\n";
51} else {
52    echo "EUID (" . $effectiveUserId . ") に紐づくユーザー情報を取得できませんでした。\n";
53}
54
55?>

PHP 8で提供されるposix_getegid関数は、現在実行中のPHPスクリプトが持つ「実効グループID（Effective Group ID、略してEGID）」を取得する役割を果たします。EGIDは、そのプロセスがシステム上でどのグループの権限で動作しているかを示す整数値です。この関数は引数を一切取らず、成功するとEGIDを整数型（int）で返します。

サンプルコードでは、まずposix拡張機能がPHPにロードされているかを確認しています。これはposix_*関数を使用する上での前提条件です。次にposix_getegid()を呼び出してEGIDを取得し、その値を表示しています。さらに、取得したEGIDをposix_getgrgid()関数に渡すことで、数字だけのIDではなく、そのEGIDに対応する具体的なグループ名も取得して表示しています。

また、関連する機能としてposix_getpwuid()関数の利用例も紹介しています。これは、現在のスクリプトの実効ユーザーID（EUID）をposix_getuid()で取得し、そのEUIDに対応するユーザーの詳細情報（ユーザー名、ホームディレクトリ、シェルなど）を連想配列として取得するものです。これらのPOSIX関数群は、PHPアプリケーションがシステム上でどのようなユーザーやグループの権限で実行されているかを確認したり、システム設定やセキュリティ関連の情報をプログラムから取得したい場合に非常に役立ちます。