posix_getgrnam

(PHP 4, PHP 5, PHP 7)

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

Описание

posix_getgrnam ( string $name ) : array|false

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

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

name

Имя группы

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

Возвращает массив (array) при успешном выполнении, или false в случае возникновения ошибки. Возвращаемый массив имеет следующие элементы:

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

Примеры

Пример #1 Пример использования posix_getgrnam()

<?php

$groupinfo 
posix_getgrnam("toons");

print_r($groupinfo);
?>

Результатом выполнения данного примера будет что-то подобное:

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

Смотрите также

  • posix_getegid() - Возвращает эффективный идентификатор группы текущего процесса EGID
  • posix_getgrgid() - Возвращает информацию о группе по её ID
  • filegroup() - Получает идентификатор группы файла
  • stat() - Возвращает информацию о файле
  • POSIX руководство GETGRNAM(3)