This function returns 'false' if the group is not found.
(PHP 4, PHP 5, PHP 7, PHP 8)
posix_getgrnam — Liefert zu einem Gruppennamen Informationen über diese Gruppe
Gibt Informationen über die durch Gruppenname angegebene Gruppe zurück.
nameDer Name der Gruppe
Gibt im Erfolgsfall ein Array zurück. Bei einem Fehler wird false zurückgegeben.
Die Elemente des zurückgegebenen Arrays sind:
| Element | Beschreibung |
|---|---|
| name |
Das name-Element enthält den Namen der Gruppe. Es handelt sich dabei
nicht um den wirklichen, kompletten Namen, sondern um einen kurzen
"Bezeichner" der Gruppe mit normalerweise weniger als 16 Zeichen. Er
sollte derselbe sein wie der Parameter name,
der beim Aufruf der Funktion verwendet wurde und ist von daher
redundant.
|
| passwd | Das passwd-Element enthält das Passwort der Gruppe in verschlüsselter Form. Häufig, zum Beispiel wenn auf einem System "shadow"-Passwörter verwendet werden, wird stattdessen ein Sternchen zurückgegeben. |
| gid | Die Gruppen-ID in numerischem Format |
| members | Besteht aus einem Array von Strings aller Gruppenmitglieder. |
Beispiel #1 Beispiel für die Verwendung von posix_getgrnam()
<?php
$gruppeninfo = posix_getgrnam("toons");
print_r($gruppeninfo);
?>Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Array
(
[name] => toons
[passwd] => x
[members] => Array
(
[0] => tom
[1] => jerry
)
[gid] => 42
)