posix_getgrgid

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

posix_getgrgid — Return info about a group by group id

Description

posix_getgrgid(int $group_id): array|false

Gets information about a group provided its id.

Parameters

group_id

The group id.

Return Values

The array elements returned are:

The group information array
ElementDescription
nameThe 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.
passwdThe 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.
gidGroup ID, should be the same as the group_id parameter used when calling the function, and hence redundant.
membersThis consists of an array of string's for all the members in the group.
The function returns false on failure.

Examples

Example #1 Example use of posix_getgrgid()

<?php

$groupid = posix_getegid();
$groupinfo = posix_getgrgid($groupid);

print_r($groupinfo);
?>

The above example will output something similar to:

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

See Also