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

# posix_getgrnam

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

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

### 説明

function posix_getgrnam(string `$name`): array|false

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

### パラメータ

`name`

  グループの名前。

### 戻り値

成功したときは array を返します。失敗した場合に `false` を返します。 配列で返される要素は下記のとおりです。

グループ情報の配列
要素 | 説明
--- | ---
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() - ファイルに関する情報を取得する
- POSIX man ページ GETGRNAM(3)

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open