Возвращает информацию о пользователе по его имени

# posix_getpwnam

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

posix_getpwnam — Возвращает информацию о пользователе по его имени

### Описание

function posix_getpwnam(string `$username`): array|false

Возвращает массив (array) с информацией о переданном пользователе.

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

`username`

  Буквенно-цифровое имя пользователя.

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

В случае успешного выполнения возвращается массив со следующими элементами, иначе возвращается `false`.

Массив с информацией о пользователе
Элемент | Описание
--- | ---
name | Элемент name содержит имя пользователя. Это короткий, обычно менее 16 символов "дескриптор" пользователя, не являющийся фактическим полным именем пользователя. Должно совпадать с именем, переданным в параметре `username` при вызове данной функции. Элемент является избыточным.
passwd | Элемент passwd содержит пароль группы в зашифрованном виде. Часто, например в системах, использующих "shadow" файлы для хранения информации о паролях, это поле содержит звёздочку.
uid | Числовой идентификатор пользователя.
gid | Идентификатор группы пользователя. Используйте функцию posix_getgrgid() для получения имени группы и списка пользователей- её членов.
gecos | GECOS является устаревшим членом, который указывает на информационное поле в системе пакетной обработки Honeywell. Однако, это поле существует, и его содержимое формализовано в стандарте POSIX. Это поле содержит список, разделённый запятыми, и содержащий в себе полное имя пользователя, рабочий телефон, номер офиса и домашний телефон. В большинстве систем доступно только полное имя пользователя.
dir | Этот элемент содержит абсолютный путь к домашней директории пользователя.
shell | Элемент shell содержит абсолютный путь к исполняемому файлу командной оболочки пользователя по умолчанию.

### Примеры

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

    <?php

    $userinfo = posix_getpwnam("tom");

    print_r($userinfo);
    ?>

Вывод приведённого примера будет похож на:

    Array
    (
        [name]    => tom
        [passwd]  => x
        [uid]     => 10000
        [gid]     => 42
        [gecos]   => "tom,,,"
        [dir]     => "/home/tom"
        [shell]   => "/bin/bash"
    )

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

- posix_getpwuid() - Возвращает информацию о пользователе, используя его ID
- POSIX руководство GETPWNAM(3)

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