posix_getgrnam

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

posix_getgrnamRetorna informação sobre um grupo a partir do nome

Descrição

posix_getgrnam(string $name): array|false

Obtém informação sobre um grupo a partir do nome fornecido.

Parâmetros

name

O nome do grupo

Valor Retornado

Retorna um array em caso de sucesso, ou false em caso de falha. 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 "identificador" curto do grupo, normalmente com menos de 16 caracteres, e não o nome real completo. Deve ser igual ao parâmetro name usado ao chamar a função e, portanto, reduntante.
passwd Este elemento contém a senha do grupo em um formato criptografado. Frequentemente, por exemplo, em um sistema que emprega senhas "ofuscadas", um asterisco é retornado.
gid ID do grupo em formato numérico.
members Este elemento consistem em um array de strings para todos os membros no grupo.

Exemplos

Example #1 Exemplo de uso de posix_getgrnam()

<?php

$groupinfo = posix_getgrnam("toons");

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_getgrgid() - Retorna informação sobre um grupo a partir de um ID de grupo
  • filegroup() - Lê o grupo do arquivo
  • stat() - Obtém informações sobre um arquivo
  • Página GETGRNAM(3) do manual POSIX