posix_getgrgid

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

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

説明

posix_getgrgid(int $group_id): array|false

指定した 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() - 現在のプロセスの有効なグループ ID を返す
  • posix_getgrnam() - 指定した名前のグループに関する情報を返す
  • filegroup() - ファイルのグループを取得する
  • stat() - ファイルに関する情報を取得する
  • POSIX man ページ GETGRNAM(3)

関連キーワード:  グループ, 情報, 指定, getgrgid, 取得, group, 配列, 関数, members, Array