posix_getgrnam

(PHP 3 >= 3.0.13, PHP 4, PHP 5)

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

説明

array posix_getgrnam ( string name )

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

パラメータ

name

グループの名前。

返り値

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

表 1. グループ情報の配列

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

変更履歴

バージョン説明
4.2.0 このバージョンより前は、members の内容は単なる整数 (グループに所属するユーザの数)であり、 メンバの名前は数値添字で返されました。

例 1. posix_getgrnam() の使用例

<?php

$groupinfo
= posix_getgrgid("toons");

print_r($groupinfo);
?>

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

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

参考

posix_getegid()
posix_getgrgid()
filegroup()
stat()
safe_mode_gid
POSIX man ページ GETGRNAM(3)