説明

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 要素には、ユーザーのデフォルトシェルの実行ファイルへの絶対パスが含まれています。

**ユーザー情報配列**
要素	説明
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)