posix_getpwuid
Name
posix_getpwuid — Returns information about a user
from the system user database (POSIX.1, 9.2.2)
Synopsis
array posix_getpwuid
(uid);
int uid: User ID of user
record to fetch
Returns
An array of user information on success, or FALSE on
failure.
Description
This function returns information about the user whose
user ID is given in uid . On
Unix-style systems this information will typically be
held in the /etc/passwd file. The information is
presented in an associated array with the following
structure:
-
name: The username.
-
passwd: Contents of
the passwd field (may be x or similar on
systems with shadow passwords enabled).
-
uid: The user ID.
-
gid: The group ID.
-
gecos: Contents of
the GECOS field; intended to hold the user's real
name. GECOS stands for 'General Electric
Comprehensive Operating System', for historical
reasons.
-
dir: The user's
home directory.
-
shell: The user's
login shell (e.g. /bin/bash).
Version
PHP 3.0.13+, PHP 4.0b4+
Example
Example 1077. Getting user
information by user ID
if (FALSE === ($pwinfo = posix_getpwuid(503))) {
echo "Could not get user information.\n";
} else {
echo "User information:\n";
print_r($pwinfo);
}
PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing
(Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch).
This material may be distributed only subject to the terms and conditions set forth
in the Open Publication License, v1.0 or later (the latest version is presently available at
http://www.opencontent.org/openpub/).
The authors of this book have elected not to choose any options under the OPL. This online book was obtained
from
http://www.fooassociates.com/phpfer/
and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4
for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All
persons and entities shall have neither liability nor responsibility to any person or entity with respect to
any loss or damage arising from the information contained in this book.