PHP Doku:: Liefert zu einer Gruppen-ID Informationen über diese Gruppe - function.posix-getgrgid.html

Verlauf / Chronik / History: (1) anzeigen

Sie sind hier:
Doku-StartseitePHP-HandbuchFunktionsreferenzErweiterungen zur ProzesskontrollePOSIXPOSIX Funktionenposix_getgrgid

Ein Service von Reinhard Neidl - Webprogrammierung.

POSIX Funktionen

<<posix_getgid

posix_getgrnam>>

posix_getgrgid

(PHP 4, PHP 5)

posix_getgrgidLiefert zu einer Gruppen-ID Informationen über diese Gruppe

Beschreibung

array posix_getgrgid ( int $gid )

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

Parameter-Liste

gid

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 gid, der beim Aufruf der Funktion verwendet wurde und ist von daher redundant.
members Besteht aus einem Array von Zeichenketten aller Gruppenmitglieder.

Changelog

Version Beschreibung
4.2.0 Vor dieser Version war members nur eine Ganzzahl, die die Anzahl der Gruppenmitglieder angab, und die Namen der Mitglieder wurden mit numerischen Indizes zurückgegeben.

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
  • safe_mode_gid
  • POSIX GETGRNAM(3)-Manpage


4 BenutzerBeiträge:
- Beiträge aktualisieren...
cweiske at php dot net
10.05.2009 16:50
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".
james at jfc dot org dot uk
16.04.2003 20:21
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
tech at dslip dot com dot au
13.05.2002 15:27
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; }
    }
rcgraves+php at brandeis dot edu
22.02.2000 3:10
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



PHP Powered Diese Seite bei php.net
The PHP manual text and comments are covered by the Creative Commons Attribution 3.0 License © the PHP Documentation Group - Impressum - mail("TO:Reinhard Neidl",...)