posix_getgrgid

指定したグループ ID を有するグループに関する情報を返す

説明

arrayfalse posix_getgrgid(int $group_id)

指定した ID のグループに関する情報を取得します。

パラメータ

group_id

グループ ID。

戻り値

以下の要素を持つ配列を返します。

グループ情報の配列
要素 説明
name グループ名。これは、16 文字以下の短い文字列からなる 「ハンドル」であり、実際の完全な名前とは異なります。
passwd グループのパスワードを暗号化したもの。 システムが「シャドー」パスワードを使用している場合は、 ここではアスタリスクが返されます。
gid グループ ID。この関数をコールする際に指定した group_id と同じものになるので、冗長なデータです。
members このグループに属する全メンバーを表す文字列の配列。
この関数は、失敗時に false を返します。

例1 posix_getgrgid の使用例

<?php

$groupid   = posix_getegid();
$groupinfo = posix_getgrgid($groupid);

print_r($groupinfo);
?>

上の例の出力は、 たとえば以下のようになります。

Array
(
    [name]    => toons
    [passwd]  => x
    [members] => Array
        (
            [0] => tom
            [1] => jerry
        )
    [gid]     => 42
)

参考

  • posix_getegid
  • posix_getgrnam
  • filegroup
  • stat
  • POSIX man ページ GETGRNAM(3)