posix_getgrnam

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

    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)
    To Top