posix_getpwuid

(PHP 4, PHP 5, PHP 7, PHP 8)

posix_getpwuid指定 ID のユーザーに関する情報を返す

説明

posix_getpwuid(int $user_id): array|false

指定したユーザー ID のユーザーについての情報を配列で返します。

パラメータ

user_id

ユーザー ID。

戻り値

返される連想配列の要素は次のようになります。

ユーザー情報配列
要素 説明
name 要素 name はユーザー名を有しています。これは、通常、 実際の完全な名前ではなく16文字未満のユーザーの"ハンドル名"となります。
passwd 要素passwd には暗号化されたユーザーのパスワードが含まれます。 シャドウパスワードを使用しているシステムでは、アスタリスクが代わりに 返されます。
uid ユーザーID。これは、この関数をコールする際に使用するパラメータ user_idと同じとなり、このため冗長になります。
gid ユーザーのグループID。 実際のグループ名を調べたりそのグループのメンバーの一覧を 得るには関数posix_getgrgid()を使用してください。
gecos GECOS は旧式の項であり、Honeywell バッチ処理プログラムの finger 情報フィールドを参照します。 しかし、このフィールドはまだ生きており、その内容はPOSIXで 規定されています。 このフィールドには、カンマで区切られた ユーザーのフルネーム、オフィスの電話番号、家の電話番号に関する リストが含まれています。多くのシステムでは、ユーザーのフルネーム のみが利用可能です。
dir この要素には、ユーザーのホームディレクトリへの絶対パスが含まれています。
shell shell 要素には、ユーザーのデフォルトシェルの実行ファイルへの絶対パスが 含まれています。
この関数は、失敗時に false を返します。

例1 posix_getpwuid() の使用例

<?php

$userinfo 
posix_getpwuid(10000);

print_r($userinfo);
?>

上の例の出力は、 たとえば以下のようになります。

Array
(
    [name]    => tom
    [passwd]  => x
    [uid]     => 10000
    [gid]     => 42
    [gecos]   => "tom,,,"
    [dir]     => "/home/tom"
    [shell]   => "/bin/bash"
)

参考

  • posix_getpwnam() - 指定した名前のユーザーに関する情報を返す
  • POSIX man ページ GETPWNAM(3)

関連キーワード:  ユーザー, 情報, 要素, 指定, 関数, getpwuid, グループ, shell, フィールド, tom