指定した名前のユーザーに関する情報を返す

# posix_getpwnam

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

posix_getpwnam — 指定した名前のユーザーに関する情報を返す

### 説明

function posix_getpwnam(string `$username`): array|false

指定したユーザーに関する情報を配列で返します。

### パラメータ

`username`

  英数字で表したユーザー名。

### 戻り値

成功した場合は次の要素を持つ配列、それ以外の場合は `false` を返します。

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

### 例

例1 posix_getpwnam() の使用例

    <?php

    $userinfo = posix_getpwnam("tom");

    print_r($userinfo);
    ?>

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

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

### 参考

- posix_getpwuid() - 指定 ID のユーザーに関する情報を返す
- POSIX man ページ GETPWNAM(3)

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open