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

Copy
1<?php
2
3/**
4 * posix_setuid の使用例を示します。
5 * この関数は、現在のスクリプトの実行ユーザーIDを変更します。
6 *
7 * 注意: 通常、この関数を成功させるには、スクリプトがroot権限で実行されている必要があります。
8 * 低い権限のユーザーから、他の低い権限のユーザーにIDを変更しようとすると失敗することがあります。
9 */
10function demonstratePosixSetuid(): void
11{
12    echo "--- posix_setuid のデモンストレーション ---" . PHP_EOL;
13
14    // 現在のユーザーID (UID) を取得して表示します。
15    $original_uid = posix_getuid();
16    echo "変更前の現在のユーザーID: " . $original_uid . PHP_EOL;
17
18    // 変更したいユーザーIDを定義します。
19    // 例として、一般的に「nobody」ユーザーのUIDとして使われる「65534」を使用します。
20    // 環境によってはこのUIDが存在しない、または別のユーザーに割り当てられている場合があります。
21    $target_uid = 65534;
22
23    echo "ターゲットユーザーID: " . $target_uid . PHP_EOL;
24
25    // posix_setuid() を使用してユーザーIDを変更を試みます。
26    echo "ユーザーIDの変更を試みます..." . PHP_EOL;
27    $result = posix_setuid($target_uid);
28
29    if ($result) {
30        echo "ユーザーIDの変更に成功しました。" . PHP_EOL;
31    } else {
32        echo "ユーザーIDの変更に失敗しました。この操作にはroot権限が必要な場合があります。" . PHP_EOL;
33        // 失敗した場合、posix_get_last_error() や error_get_last() で
34        // 詳細なエラー情報を取得できる場合があります。
35    }
36
37    // 変更後のユーザーIDを再度取得して表示します。
38    // 成功した場合は $target_uid と一致し、失敗した場合は $original_uid のままです。
39    $current_uid = posix_getuid();
40    echo "変更後の現在のユーザーID: " . $current_uid . PHP_EOL;
41
42    if ($original_uid === $current_uid) {
43        echo "ユーザーIDは変更されませんでした (変更失敗または同じUIDへの変更)。" . PHP_EOL;
44    } elseif ($current_uid === $target_uid) {
45        echo "ユーザーIDはターゲットIDに正常に変更されました。" . PHP_EOL;
46    }
47    echo "------------------------------------------" . PHP_EOL;
48}
49
50// 上記で定義した関数を実行します。
51demonstratePosixSetuid();
52
53?>

PHPのposix_setuid関数は、実行中のPHPスクリプトが動作するシステム上のユーザーID（UID）を変更するために使用されます。引数には、変更したいターゲットとなるユーザーの数値ID（int $user_id）を指定します。この関数は、ユーザーIDの変更処理に成功した場合はtrueを、失敗した場合はfalseをブール値で返します。

サンプルコードでは、まずposix_getuid()関数を使って変更前の現在のユーザーIDを取得し、表示しています。その後、特定のユーザーID（例として、一般的に低権限ユーザーに割り当てられることが多い65534）をターゲットとして設定し、posix_setuid()を呼び出してユーザーIDの変更を試みます。変更の成否は関数の戻り値によって判定され、その結果がメッセージとして表示されます。最後に、再度posix_getuid()を呼び出すことで、実際にユーザーIDが変更されたか、あるいは元のIDのままであるかを確認しています。

この関数を使用する上での重要な注意点として、ユーザーIDの変更はシステムセキュリティに関わる操作であるため、通常はスクリプトがroot権限（管理者権限）で実行されている場合にのみ成功します。権限が不足している環境で実行した場合、ユーザーIDの変更は失敗し、スクリプトは元のユーザーIDのままで実行を継続します。

Copy
1<?php
2
3/**
4 * PHPのposix_setuid関数とposix_getpwuid関数の使用例を示す関数です。
5 *
6 * この関数は、スクリプトの実行ユーザーIDを変更するプロセスをデモンストレーションします。
7 * 主に、スーパーユーザー権限で実行されているPHPプロセスが、セキュリティのために
8 * 特権を一時的に下げて、より低い権限のユーザー（例：'nobody'）として操作を行う場合に使用されます。
9 *
10 * 注意事項:
11 * 1. posix_setuid関数は、通常、root権限でPHPプロセスが実行されている場合にのみ成功します。
12 *    ウェブサーバー環境では、セキュリティ上の理由からこのような操作が許可されていないことがほとんどです。
13 * 2. ターゲットとなるユーザーIDは、システムに実際に存在するものである必要があります。
14 *    一般的なLinuxシステムでは'nobody'ユーザーのUIDは65534ですが、環境によって異なります。
15 *    `id -u nobody` のようなコマンドで確認できます。
16 *
17 * @param int $target_user_id 変更したいユーザーのID (UID)。
18 * @return void
19 */
20function demonstratePosixSetuid(int $target_user_id): void
21{
22    echo "--- posix_setuid 関数のデモンストレーション --- \n\n";
23
24    // 1. 現在の実行ユーザー情報を取得し表示します。
25    // posix_getuid() で現在の実効ユーザーIDを取得し、posix_getpwuid() でそのIDのユーザー情報を取得します。
26    $current_uid = posix_getuid();
27    $current_user_info = posix_getpwuid($current_uid);
28
29    if ($current_user_info === false) {
30        echo "エラー: 現在のユーザー情報を取得できませんでした。POSSIX拡張が有効か確認してください。\n";
31        return;
32    }
33
34    echo "現在の実行ユーザー情報:\n";
35    echo "  UID: {$current_user_info['uid']} ({$current_user_info['name']})\n";
36    echo "  GID: {$current_user_info['gid']}\n";
37    echo "  ホームディレクトリ: {$current_user_info['dir']}\n\n";
38
39    // 2. 変更先のユーザー情報を取得し表示します。
40    // ここで指定する $target_user_id がどのようなユーザーなのかを posix_getpwuid() で確認します。
41    $target_user_info = posix_getpwuid($target_user_id);
42
43    if ($target_user_info === false) {
44        echo "エラー: 指定されたターゲットユーザーID ({$target_user_id}) の情報を取得できませんでした。\n";
45        echo "このUIDのユーザーがシステムに存在するか確認してください。\n\n";
46        return;
47    }
48
49    echo "ターゲットとなるユーザー情報:\n";
50    echo "  UID: {$target_user_info['uid']} ({$target_user_info['name']})\n";
51    echo "  GID: {$target_user_info['gid']}\n";
52    echo "  ホームディレクトリ: {$target_user_info['dir']}\n\n";
53
54    // 3. posix_setuid() を実行してユーザーIDを変更します。
55    echo "実行ユーザーIDを {$target_user_id} ({$target_user_info['name']}) に変更しようとしています...\n";
56    $success = posix_setuid($target_user_id);
57
58    if ($success) {
59        echo "ユーザーIDの変更に成功しました！\n\n";
60
61        // 4. 変更後の実行ユーザー情報を再度取得し、変更が反映されたことを確認します。
62        $new_current_uid = posix_getuid();
63        $new_current_user_info = posix_getpwuid($new_current_uid);
64
65        if ($new_current_user_info === false) {
66            echo "エラー: 変更後のユーザー情報を取得できませんでした。\n";
67            return;
68        }
69
70        echo "変更後の実行ユーザー情報:\n";
71        echo "  UID: {$new_current_user_info['uid']} ({$new_current_user_info['name']})\n";
72        echo "  GID: {$new_current_user_info['gid']}\n";
73        echo "  ホームディレクトリ: {$new_current_user_info['dir']}\n";
74    } else {
75        echo "ユーザーIDの変更に失敗しました。\n";
76        echo "この操作は通常、スーパーユーザー権限 (root) で実行する必要があります。\n";
77        echo "現在のUID: {$current_user_info['uid']} ({$current_user_info['name']})\n";
78        echo "PHPのエラーメッセージ: " . posix_strerror(posix_get_last_error()) . " (エラーコード: " . posix_get_last_error() . ")\n";
79    }
80}
81
82// スクリプトの実行例:
83// このスクリプトは、ターミナルからPHP CLIで実行できます。
84// 例: `php your_script_name.php`
85// 成功させるには、`sudo php your_script_name.php` のようにroot権限で実行する必要があるかもしれません。
86
87// ターゲットユーザーのUIDを指定します。
88// 一般的なLinuxシステムでの 'nobody' ユーザーのUIDは 65534 です。
89// お使いの環境に合わせて適切なUIDに変更してください。
90// 例えば、Debian/Ubuntu系ではウェブサーバーユーザーが 'www-data' (UID 約 33) であることが多いです。
91$target_nobody_uid = 65534; // 例: 'nobody' ユーザーのUID
92
93demonstratePosixSetuid($target_nobody_uid);
94
95// 別のターゲットUIDで試したい場合は、以下のコメントを解除して実行してください。
96// 例: root ユーザー (UID 0) に変更しようとする場合 (root権限で実行している場合のみ意味があります)
97// $target_root_uid = 0;
98// echo "\n\n--- 別のターゲットUID ({$target_root_uid}) で再試行 --- \n";
99// demonstratePosixSetuid($target_root_uid);
100
101?>

PHPのposix_setuid関数は、実行中のスクリプトのユーザーID（UID）を変更するために使用されます。引数$user_idには、変更したいターゲットユーザーのUIDを整数で指定します。この関数は、処理が成功した場合はtrueを、失敗した場合はfalseをブール値で返します。主に、スーパーユーザー（root）権限で実行されているPHPプロセスが、セキュリティ上の理由から特権を一時的に下げ、より低い権限のユーザーとして動作したい場合に利用されます。

サンプルコードでは、まずposix_getuidで現在の実行ユーザーIDを取得し、キーワードとして指定されているposix_getpwuid関数を使ってその詳細なユーザー情報を表示しています。次に、変更したいターゲットユーザーIDの情報を同じくposix_getpwuidで確認します。その後、posix_setuidを実行して実際にユーザーIDを変更し、再度posix_getuidとposix_getpwuidで変更が反映されたかを確認する流れです。posix_setuidの実行には通常、root権限が必要です。権限が不足している場合や指定されたUIDが存在しない場合など、失敗するケースも示しています。posix_getpwuidは、指定されたUIDを持つユーザーの情報を連想配列で取得する関数です。