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

down

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; }
    }

down

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".

down

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

down

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

＋Добавить