posix_getpwnam
(PHP 4, PHP 5, PHP 7)
posix_getpwnam — 指定した名前のユーザーに関する情報を返す
説明
posix_getpwnam
( string $username
) : array
指定したユーザーに関する情報を配列で返します。
パラメータ
username- 英数字で表したユーザー名。
返り値
成功した場合は次の要素を持つ配列、それ以外の場合は
false を返します。
| 要素 | 説明 |
|---|---|
| name | 要素 name はユーザー名を有しています。これは、通常、
実際の完全な名前ではなく16文字未満のユーザーの"ハンドル名"となります。
この値はこの関数をコールした際に使用したパラメータ
|
| 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"
)
