PHP Conference Nagoya 2025

posix_getgrgid

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

posix_getgrgidВозвращает информацию о группе по её ID

Описание

posix_getgrgid(int $group_id): array|false

Возвращает информацию о группе, используя её ID.

Список параметров

group_id

Идентификатор группы.

Возвращаемые значения

Массив со следующими элементами:

Массив с информацией о группе
Элемент Описание
name Элемент name содержит имя группы. Это короткий, обычно менее 16 символов "дескриптор" группы, не являющийся полным именем группы.
passwd Элемент passwd содержит пароль группы в зашифрованном виде. Часто, например в системах, использующих "shadow" файлы для хранения информации о паролях, это поле содержит строку из звёздочек.
gid Элемент содержит ID группы и должен соответствовать group_id параметру, используемому при вызове функции. Данный элемент является избыточным.
members Этот элемент состоит из array, содержащего string. Значениями данного массива являются имена членов данной группы.
Функция возвращает false в случае возникновения ошибки.

Примеры

Пример #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() - Возвращает эффективный идентификатор группы текущего процесса EGID
  • posix_getgrnam() - Возвращает информацию о группе, используя её имя
  • filegroup() - Получает идентификатор группы файла
  • stat() - Возвращает информацию о файле
  • POSIX руководство GETGRNAM(3)

Добавить

Примечания пользователей 4 notes

up
1
tech at dslip dot com dot au
22 years ago
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; }
}
up
0
cweiske at php dot net
15 years ago
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".
up
0
james at jfc dot org dot uk
21 years ago
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
up
0
rcgraves+php at brandeis dot edu
24 years ago
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
To Top