PHP Conference Nagoya 2025

posix_getgrgid

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

posix_getgrgidRetorna informação sobre um grupo a partir de um ID de grupo

Descrição

posix_getgrgid(int $group_id): array|false

Obtém informação sobre um grupo a partir de seu ID fornecido.

Parâmetros

group_id

O ID de grupo.

Valor Retornado

Os elementos de array retornados são:

O array de informação de grupo
Elemento Descrição
name Este elemento contém o nome do grupo. É um nome curto, geralmente um "identificador" do grupo com menos de 16 caracteres, mas não o nome real, completo, do grupo.
passwd Ese elemento contém a senha do grupo em um formato criptografado. Muitas vezes, por exemplo, em um sistema que emprega senhas "ofuscadas", um asterisco é retornado.
gid ID do grupo, deve ser o mesmo que o parâmetro group_id usado na chamada à função e, por isso, redundante.
members Consiste em um array de strings para todos os membros do grupo.
A função retorna false em caso de falha.

Exemplos

Exemplo #1 Exemplo de uso de posix_getgrgid()

<?php

$groupid
= posix_getegid();
$groupinfo = posix_getgrgid($groupid);

print_r($groupinfo);
?>

O exemplo acima produzirá algo semelhante a:

Array
(
    [name]    => toons
    [passwd]  => x
    [members] => Array
        (
            [0] => tom
            [1] => jerry
        )
    [gid]     => 42
)

Veja Também

  • posix_getegid() - Retorna o ID do grupo efetivo do processo atual
  • posix_getgrnam() - Retorna informação sobre um grupo a partir do nome
  • filegroup() - Lê o grupo do arquivo
  • stat() - Obtém informações sobre um arquivo
  • Página GETGRNAM(3) do manual POSIX

adicione uma nota

Notas Enviadas por Usuários (em inglês) 4 notes

up
1
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; }
}
up
0
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".
up
0
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
up
0
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
To Top