PHP Manual
POSIX Funktionen
Liefert zu einem Benutzernamen Informationen über diesen Benutzer

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"
)