posix_getgrgid

(PHP 4, PHP 5)

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

説明

array posix_getgrgid ( int $gid )

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

パラメータ

gid: グループ ID。

返り値

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

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

変更履歴

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

例

例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() - ファイルに関する情報を取得する
safe_mode_gid
POSIX man ページ GETGRNAM(3)

posix_getgrnam

posix_getgid

Last updated: Fri, 13 Nov 2009

add a note User Contributed Notes
posix_getgrgid

cweiske at php dot net
10-May-2009 11:50


When posix_getgrgid() fails (e.g. an invalid/unknown group id), it returns false.

This is except for Mac OSX on which you get an array with name "nogroup" and gid of "-1".

james at jfc dot org dot uk
17-Apr-2003 03:21


in php-4.3 the array returned seems to have changed.



it now returns:



["name"] group name

["passwd"] group password

["members"] group members (array of usernames)

["gid"] numeric group id

tech at dslip dot com dot au
13-May-2002 10:27


okies...



This code should be considered as an OPTION only, it works under MY set of circumstances, and that is all I intended. The below funtion will return the NAME of the GROUP if provided with the Group ID#



  function RC_posix_getgrgid($gid) 

    {

    $LocationGroup = "/etc/group"; //EDIT THIS IF YOU HAVE A DIFFERENT OS. mine = debian

    $fp = fopen ("/etc/group","r");

    while ($groupinfo = fscanf ($fp, "%[a-zA-Z0-9]:x:%[0-9]:%[a-zA-Z0-9]\n")) 

        {

        list ($name, $groupID, $nfi) = $groupinfo;

        if ($groupID == $gid)

            {

            $returnval = $name;

            }

        }

    fclose($fp);

    if($returnval) { return $returnval; } else { return 0; }

    }

rcgraves+php at brandeis dot edu
22-Feb-2000 11:10


Returns an array containing the elements of the group structure. The array has both numeric indices, each of which is a string naming one member of the group, and named string indices. The array elements are:





$_["name"]  string groupname (users)


$_["gid"] integer gidnumber (e.g. 0 for wheel/root)


$_["members"] int number of users in group


$_[0]..$_[n] string usernames in the group

add a note

posix_getgrnam

posix_getgid

Last updated: Fri, 13 Nov 2009