無料CGI、PHPサイト(確認画面付きメールフォーム・メーリングリスト・メルマガ設置、逆アクセスランキング、画像カウンター等)PHPマニュアル by k-sky

posix_getpwnam

(PHP 4, PHP 5)

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

説明

array posix_getpwnam ( string $username )

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

パラメータ

username

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

返り値

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

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

参考