posix_getgrgid

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

posix_getgrgid — Liefert zu einer Gruppen-ID Informationen über diese Gruppe

Beschreibung

posix_getgrgid(int $group_id): array|false

Gibt Informationen über die Gruppe mit der angegebenen ID zurück.

Parameter-Liste

group_id: Die Gruppen-ID

Rückgabewerte

Die Elemente des zurückgegebenen Arrays sind:

**Das Array mit Gruppeninformationen**
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.
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 - sollte dieselbe sein wie der Parameter `group_id`, der beim Aufruf der Funktion verwendet wurde und ist von daher redundant.
members	Besteht aus einem Array von Zeichenketten aller Gruppenmitglieder.

Falls ein Fehler auftritt, gibt die Funktion false zurück.

Beispiele

Beispiel #1 Beispiel zur Verwendung von posix_getgrgid()

<?php

$gruppenid   = posix_getegid();
$gruppeninfo = posix_getgrgid($gruppenid);

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
)

Siehe auch

posix_getegid() - Liefert die effektive Gruppen-ID des aktuellen Prozesses
posix_getgrnam() - Liefert zu einem Gruppennamen Informationen über diese Gruppe
filegroup() - Liefert die Gruppenzugehörigkeit einer Datei
stat() - Sammelt Informationen über eine Datei
POSIX GETGRNAM(3)-Manpage

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 4 notes

down

tech at dslip dot com dot au ¶

22 years ago

okies...

This code should be considered as an OPTION only, it works under MY set of circumstances, and that is all I intended. The below funtion will return the NAME of the GROUP if provided with the Group ID#

  function RC_posix_getgrgid($gid) 
    {
    $LocationGroup = "/etc/group"; //EDIT THIS IF YOU HAVE A DIFFERENT OS. mine = debian
    $fp = fopen ("/etc/group","r");
    while ($groupinfo = fscanf ($fp, "%[a-zA-Z0-9]:x:%[0-9]:%[a-zA-Z0-9]\n")) 
        {
        list ($name, $groupID, $nfi) = $groupinfo;
        if ($groupID == $gid)
            {
            $returnval = $name;
            }
        }
    fclose($fp);
    if($returnval) { return $returnval; } else { return 0; }
    }

down

cweiske at php dot net ¶

15 years ago

When posix_getgrgid() fails (e.g. an invalid/unknown group id), it returns false.
This is except for Mac OSX on which you get an array with name "nogroup" and gid of "-1".

down

james at jfc dot org dot uk ¶

21 years ago

in php-4.3 the array returned seems to have changed.

it now returns:

["name"] group name
["passwd"] group password
["members"] group members (array of usernames)
["gid"] numeric group id

down

rcgraves+php at brandeis dot edu ¶

24 years ago

Returns an array containing the elements of the group structure. The array has both numeric indices, each of which is a string naming one member of the group, and named string indices. The array elements are:



$_["name"]  string groupname (users)

$_["gid"] integer gidnumber (e.g. 0 for wheel/root)

$_["members"] int number of users in group

$_[0]..$_[n] string usernames in the group

＋add a note