posix_getpwnam

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

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

説明

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)

関連キーワード:  ユーザー, 情報, 名前, 要素, 指定, getpwnam, tom, フィールド, グループ, passwd