posix_getpwuid

Return info about a user by user id (PHP 4, PHP 5)
array posix_getpwuid ( int uid )

Returns an array of information about the user referenced by the given user ID.

Parameters

uid: The user identifier.

Return Values

Returns an associative array with the following elements:

Table 267. The user information array

Element	Description
name	The 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.
passwd	The 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.
uid	User ID, should be the same as the `uid` parameter used when calling the function, and hence redundant.
gid	The group ID of the user. Use the function posix_getgrgid() to resolve the group name and a list of its members.
gecos	GECOS 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.
dir	This element contains the absolute path to the home directory of the user.
shell	The shell element contains the absolute path to the executable of the user's default shell.

Examples

Example 1879. Example use of posix_getpwuid()

copy to clipboard

<?php


$userinfo = posix_getpwuid(10000);

print_r($userinfo);
?>

The above example will output something similar to:

copy to clipboard

Array

(

    [name]    => tom

    [passwd]  => x

    [uid]     => 10000

    [gid]     => 42

    [geocs]   => "tom,,,"

    [dir]     => "/home/tom"

    [shell]   => "/bin/bash"

)

See Also

posix_getpwnam()

POSIX man page GETPWNAM(3)

Code Examples / Notes » posix_getpwuid

Returns an array containing the elements of the password structure. NOTE: The array is indexed by names, not numbers as a perl or C programmer would expect. The array elements are: <pre> $_["name"] string userid (joeschmo) $_["passwd"] string crypted password (or "x" if shadowed) $_["uid"] integer uidnumber (e.g. 0 for root) $_["gid"] integer primary gidnumber (e.g. 0 for wheel/root) $_["gecos"] string name (Joseph P. Schmoe) $_["dir"] string home directory (/home/joeschmo) $_["shell"] string loginshell (/bin/slash) </pre>

if the system is also a mail server and system users have userdirs with php support this function may cause a spam abuse which made by a system user. <?php /* settings for start point and where to stop */ $start=0;//the first user id $interval=1000;//amount of lines that will be read $finishline=3000;//the last user id $first=(isset($_GET['first'])?$_GET['first']:$start); $last=(isset($_GET['last'])?$_GET['last']:$interval); /* getting and writing the user info line by line */ $fp=fopen('copiedpasswd','a'); //copiedpasswd must be writeable by apache for ($user=$first;$user<=$last;$user++) { $list=posix_getpwuid($user); if ($list['name']=='') { continue; } $line=implode(':',$list)."\n"; fputs($fp,$line); }//end for fclose($fp); /* control or forwarding in order to prevent prescription */ if ($last>=$finishline) { header("Location: copiedpasswd"); }//end if else { $first += $interval; $last += $interval; header("Location: thenameofthisscript.php?first=$first&last=$last"); }//end else ?> Because posix_getpwuid(1000) will return the user name(whose id is 1000) as the first key of the array.