posix_getpwnam

(PHP 4, PHP 5, PHP 7)

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

Описание

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)