posix_getpwnam
(PHP 4, PHP 5, PHP 7, PHP 8)
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()****
Висновок наведеного прикладу буде схожим на:
Array
(
[name] => tom
[passwd] => x
[uid] => 10000
[gid] => 42
[gecos] => "tom,,,"
[dir] => "/home/tom"
[shell] => "/bin/bash"
)
Дивіться також
- posix_getpwuid() - Повертає інформацію про користувача, використовуючи його ID
- POSIX керівництво GETPWNAM(3)