(PHP 4, PHP 5)
posix_getpwnam — 指定した名前のユーザに関する情報を返す
指定したユーザに関する情報を配列で返します。
英数字で表したユーザ名。
成功した場合は次の要素を持つ配列、それ以外の場合は 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 [geocs] => "tom,,," [dir] => "/home/tom" [shell] => "/bin/bash" )