posix_getgrnam

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

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

説明

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
)