POSIX 函数
在线手册:中文 英文
PHP手册

posix_getgrgid

(PHP 4, PHP 5)

posix_getgrgidReturn info about a group by group id

说明

array posix_getgrgid ( int $gid )

Gets information about a group provided its id.

参数

gid

The group id.

返回值

The array elements returned are:

The group information array
Element Description
name The name element contains the name of the group. This is a short, usually less than 16 character "handle" of the group, not the real, full name.
passwd The passwd element contains the group's password in an encrypted format. Often, for example on a system employing "shadow" passwords, an asterisk is returned instead.
gid Group ID, should be the same as the gid parameter used when calling the function, and hence redundant.
members This consists of an array of string's for all the members in the group.

更新日志

版本 说明
4.2.0 Prior to this version, members was simply an integer representing the number of members in the group, and the member names were returned with numerical indices.

范例

Example #1 Example use of 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 函数
在线手册:中文 英文
PHP手册
PHP手册 - N: Return info about a group by group id

用户评论:

cweiske at php dot net (10-May-2009 03: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 (16-Apr-2003 07: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 02: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 02: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