# posix_getpwnam

(PHP 4, PHP 5, PHP 7, PHP 8)

posix_getpwnam — Retourne des informations sur un utilisateur

### Description

posix_getpwnam(string `$username`): array|false

Retourne un tableau d'informations sur un utilisateur.

### Liste de paramètres

`username`

  Un nom alphanumérique d'utilisateur.

### Valeurs de retour

En cas de succès, un tableau avec les éléments suivants est retourné, sinon, `false` :

Le tableau descriptif d'un utilisateur
Élément | Description
--- | ---
name | Le nom contient le nom de l'utilisateur. Généralement, c'est un nom court, de moins de 16 caractères, mais ce n'est pas son nom réel et complet. Cette valeur devrait correspondre au paramètre `username` et, donc, il est redondant.
passwd | Contient le mot de passe de l'utilisateur, chiffré. Souvent, dans les systèmes utilisant les mots de passe "fantômes", un astérisque est retourné.
uid | L'UID de l'utilisateur.
gid | L'ID du groupe de l'utilisateur. Utilisez la fonction posix_getgrgid() pour connaître le nom du groupe, et ses membres.
gecos | GECOS est un terme obsolète qui fait référence aux données de finger, sur un système Honeywell. Le champ, cependant, a survécu, et son contenu a été formalisé par POSIX. Le champ contient une liste, séparée par des virgules, qui contient le nom complet de l'utilisateur, son téléphone professionnel, son numéro de téléphone bureau et son numéro de téléphone personnel. Sur la plupart des systèmes, seul le nom est disponible.
dir | Cet élément contient le chemin absolu jusqu'au dossier racine de l'utilisateur.
shell | Cet élément contient le chemin absolu jusqu'au dossier d'exécution du shell de l'utilisateur.

### Exemples

Exemple #1 Exemple avec posix_getpwnam()

`<?php
$userinfo = posix_getpwnam("tom");
print_r($userinfo);
?>`

Résultat de l'exemple ci-dessus est similaire à :

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

### Voir aussi

- posix_getpwuid() - Retourne des informations sur un utilisateur
- POSIX man page GETPWNAM(3)