HomeMenu
Jesus · Bible · HTML · CSS · JS · PHP · SVG · Applications

posix_getpwuid

Description

The posix_getpwuid of POSIX for PHP returns information about a user by user id.

Syntax

posix_getpwuid(
    int $user_id
): array|false

Parameters

user_id

The user identifier.

Return

Returns an array of elements on success, or false on failure.

ElementDescription
nameThe name element contains the username of the user. This is a short, usually less than 16 character "handle" of the user, not the real, full name.
passwdThe passwd element contains the user's password in an encrypted format. Often, for example on a system employing "shadow" passwords, an asterisk is returned instead.
uidUser ID of the user in numeric form. This should be the same as the user_id parameter used when calling the function, and hence redundant.
gidGroup ID of the user. Use the function posix_getgrgid() to resolve the group name and a list of its members.
gecosGECOS is an obsolete term that refers to the finger information field on a Honeywell batch processing system. The field, however, lives on, and its contents have been formalized by POSIX. The field contains a comma separated list containing the user's full name, office phone, office number, and home phone number. On most systems, only the user's full name is available.
dirThis element contains the absolute path to the home directory of the user.
shellThe shell element contains the absolute path to the executable of the user's default shell.

Examples

1 · user_id

<?

$user_id = 10000;

$return = posix_getpwuid($user_id);

print_r($return);

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