posix_getpwnam

posix_getpwnam(string $username): array
```php

Devuelve un `array` de información sobre el usuario dado.

## Parámetros

`username`  
Un nombre de usuario alfanumérico.

## Valores devueltos

En caso de éxito se devuelve un array con los siguientes elementos, si no se devuelve `false`:

| Elemento | Descripción |
|----|----|
| name | El elemento name contiene el nombre del grupo. Es una abreviatura, normalmente menos de 16 caracteres "soportan" el groupo, no el nombre real completo. Debería se el mismo que el parámetro `username` usado al llamar a la función, y por lo tanto redundante. |
| passwd | El elemento passwd contiene la contraseña del grupo 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 en forma numérica. |
| gid | El ID de grupo del usuario. Use 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 que contiene 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 de usuario. |

El array de información de usuario

## Ejemplos

Ejemplo de uso de `posix_getpwnam`

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