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)