posix_getgid
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".
posix_getgrgid
(PHP 4, PHP 5)
posix_getgrgid — Retourne des informations sur un groupe
Description
array posix_getgrgid
( int
$gid
)Retourne des informations sur un groupe.
Liste de paramètres
-
gid -
L'identifiant du groupe.
Valeurs de retour
Les éléments du tableau retourné sont :
| Élément | Description |
|---|---|
| name | Cet élément contient le nom du groupe. C'est un nom abrégé, habituellement, moins de 16 caractères, représentant le nom du groupe et non le nom du groupe complet. |
| passwd | Cet élément contient le mot de passe du groupe, crypté. Par exemple, sous les systèmes employant les mots de passe "shadow", un astérisque est retourné. |
| gid |
ID du groupe, doit être le même que le paramètre
gid utilisé lors de l'appel à la
fonction.
|
| members | C'est un tableau de chaînes de caractères représentant tous les membres du groupe. |
Historique
| Version | Description |
|---|---|
| 4.2.0 | Depuis PHP 4.2.0, les membres sont retournés sous la forme d'un tableau de membres. Avant cela, la fonction ne retournait que le nombre de membres du groupe, et les membres étaient identifiés par leur index numérique. |
Exemples
Exemple #1 Exemple avec posix_getgrgid()
<?php
$groupid = posix_getegid();
$groupinfo = posix_getgrgid($groupid);
print_r($groupinfo);
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Array
(
[name] => toons
[passwd] => x
[members] => Array
(
[0] => tom
[1] => jerry
)
[gid] => 42
)
Voir aussi
- posix_getegid() - Retourne l'ID effectif du groupe du processus courant
- posix_getgrnam() - Retourne des informations sur un groupe
- filegroup() - Lire le nom du groupe
- stat() - Renvoie les informations à propos d'un fichier
- safe_mode_gid
- POSIX man page GETGRNAM(3)
add a note
User Contributed Notes
posix_getgrgid - [4 notes]
cweiske at php dot net ¶
4 years ago
james at jfc dot org dot uk ¶
10 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
tech at dslip dot com dot au ¶
11 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; }
}
rcgraves+php at brandeis dot edu ¶
13 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