posix_getgrgid

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

posix_getgrgid — Return info about a group by group id

说明

posix_getgrgid(int $group_id): array|false

Gets information about a group provided its id.

参数

group_id: 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 group_id 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.

The function returns false on failure.

**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 `group_id` 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.

示例

示例 #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_getegid() - Return the effective group ID of the current process
posix_getgrnam() - Return info about a group by name
filegroup() - 取得文件的组
stat() - 给出文件的信息
POSIX man page GETGRNAM(3)