# posix_getpwnam

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

posix_getpwnam — Liefert zu einem Benutzernamen Informationen über diesen Benutzer

### Beschreibung

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

Gibt ein Array mit Informationen über den angegebenen Benutzer zurück.

### Parameter-Liste

`username`

  Ein alphanumerischer Benutzername

### Rückgabewerte

Bei Erfolg wird ein Array mit den folgenden Elementen zurückgegeben, andernfalls `false`:

Das Benutzerinformation-Array
Element | Beschreibung
--- | ---
name | Das name-Element enthält den Benutzernamen. Es handelt sich dabei nicht um den wirklichen, kompletten Namen, sondern um einen kurzen "Bezeichner" des Benutzers mit normalerweise weniger als 16 Zeichen. Der Benutzername sollte derselbe wie der bei Aufruf der Funktion verwendete Parameter `username` sein und ist von daher redundant.
passwd | Das passwd-Element enthält das verschlüsselte Passwort des Benutzers. Häufig, zum Beispiel wenn auf einem System "shadow"-Passwörter verwendet werden, wird stattdessen ein Sternchen zurückgegeben.
uid | Die Benutzer-ID in numerischem Format.
gid | Die Gruppen-ID des Benutzers. Benutzen Sie die Funktion posix_getgrgid(), um den Gruppennamen und eine Liste der Gruppenmitglieder aufzulösen.
gecos | GECOS ist ein veralteter Begriff, der sich auf das finger-Informationsfeld auf einem Honeywell-Stapelverarbeitungssystem bezieht. Das Feld gibt es aber immer noch und sein Inhalt wurde durch POSIX formalisiert. Es enthält eine durch Komma getrennte Liste, bestehend aus dem kompletten Namen der Benutzerin, der Telefonnummer des Büros, der Zimmernummer des Büros und der privaten Telefonnummer. Auf den meisten Systemen ist nur der komplette Name des Benutzers verfügbar.
dir | Dieses Element enthält den absoluten Pfad des Homeverzeichnisses des Benutzers.
shell | Das shell-Element enthält den absoluten Pfad zur standardmäßigen Shell des Benutzers.

### Beispiele

Beispiel #1 posix_getpwnam()-Beispiel

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

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

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

### Siehe auch

- posix_getpwuid() - Liefert zu einer Benutzer-ID Informationen über diesen Benutzer
- POSIX GETPWNAM(3)-Manpage

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open