posix_getpwuid

(PHP 4, PHP 5, PHP 7)

posix_getpwuidDevolver información sobre un usuario mediante su id de usuario

Descripción

posix_getpwuid ( int $uid ) : array

Devuelve un array de información sobre el usuario denotado por el ID de usuario dado.

Parámetros

uid

El identificador de usuario.

Valores devueltos

Devuelve un array asociativo con los siguientes elementos:

El array de información de usuario
Elemento Descripción
name El elemento 'name' contiene el nombre de usuario. Es una abreviatura, normalmente un "apodo" de menos de 16 caracteres del nombre del usuario, no el nombre real completo.
passwd El elemento 'passwd' contiene la contraseña del usuario en un formato encriptado. A menudo, por ejemplo, bajo un sistema que emplea contraseñas "shadow", se devuelve un asterisco en su lugar.
uid El ID del usuario, debería ser el mismo que el del parámetro uid empleado al llamar a la función, y por lo tanto redundante.
gid El ID de grupo del usuario. Emplee la función posix_getgrgid() para resolver el nombre de grupo y una lista de sus miembros.
gecos GECOS es un término obosleto que se refiere al campo de información "finger" de un sistema de procesamiento por lotes Honeywell. El campo, sin embargo, todavía existe, y su contenido ha sido formalizado por POSIX. El campo contiene una lista separada por comas con el nombre completo del usuario, teléfono de oficina, número de oficina, y el número de teléfono de casa. En la mayoría de los sistemas solo está disponible el nombre de usuario completo.
dir Este elemento contiene la ruta absoluta al directorio "home" del usuario.
shell El elemento 'shell' contiene la ruta absoluta al ejecutable del shell predeterminado del usuario.

Ejemplos

Ejemplo #1 Ejemplo de uso de posix_getpwuid()

<?php

$userinfo 
posix_getpwuid(10000);

print_r($userinfo);
?>

El resultado del ejemplo sería algo similar a:

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

Ver también

  • posix_getpwnam() - Devolver información sobre un usuario mediante su nombre de usuario
  • Página GETPWNAM(3) del man de POSIX