指定した名前のグループに関する情報を返す

# posix_getgrnam

(PHP 4, PHP 5, PHP 7)

posix_getgrnam — 指定した名前のグループに関する情報を返す

### 説明

posix_getgrnam ( string `$name` ) : array

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

### パラメータ

`name`

  グループの名前。

### 返り値

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

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

### 例

例1 posix_getgrnam() の使用例

`<?php
$groupinfo = posix_getgrnam("toons");
print_r($groupinfo);
?>`

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

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

### 参考

- posix_getegid() - 現在のプロセスの有効なグループ ID を返す
- posix_getgrgid() - 指定したグループ ID を有するグループに関する情報を返す
- filegroup() - ファイルのグループを取得する
- stat() - ファイルに関する情報を取得する
- safe_mode_gid
- POSIX man ページ GETGRNAM(3)