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 — Devolver información sobre un grupo mediante un id de grupo
Descripción
array posix_getgrgid
( int
$gid
)Obtiene información sobre un grupo porporcionando su id.
Parámetros
-
gid -
El id del grupo.
Valores devueltos
Los elementos del array devueltos son:
| Elemento | Descripción |
|---|---|
| name | El elemento name contiene el nombre del grupo. Es una abreviatura, normalmente menos de 16 caracteres "soportan" el groupo, no el nombre real completo. |
| passwd | El elemento passwd contiene la contraseña del grupo en un formato encriptado. A menudo, por ejemplo bajo un sistema que emplea contraseñas "shadow", se devuelve un asterisco en su lugar. |
| gid |
El ID del grupo, debería ser el mismo que el del
parámetro gid usado al llamar a la
función, y por lo tanto redundante.
|
| members | Consiste en un array de strings de todos los miembros del grupo. |
Historial de cambios
| Versión | Descripción |
|---|---|
| 4.2.0 | Antes de esta versión, members era simplemente un entero que representaba el número de miembros del grupo, y los nombres de los miembros eran devueltos con índices numéricos. |
Ejemplos
Ejemplo #1 Ejemplo de uso de posix_getgrgid()
<?php
$groupid = posix_getegid();
$groupinfo = posix_getgrgid($groupid);
print_r($groupinfo);
?>
El resultado del ejemplo sería algo similar a:
Array
(
[name] => toons
[passwd] => x
[members] => Array
(
[0] => tom
[1] => jerry
)
[gid] => 42
)
Ver también
- posix_getegid() - Devuelve el ID efectivo de grupo del proceso actual
- posix_getgrnam() - Devolver información sobre un grupo mediante su nombre
- filegroup() - Obtiene el grupo de un archivo
- stat() - Da información acerca de un fichero
- 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