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

# posix_getgrnam

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

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

### Описание

function 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)

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open