array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.posix-getgrnam.php', 1 => 'posix_getgrnam', 2 => 'Retorna informação sobre um grupo a partir do nome', ), 'up' => array ( 0 => 'ref.posix.php', 1 => 'Funções de POSIX', ), 'prev' => array ( 0 => 'function.posix-getgrgid.php', 1 => 'posix_getgrgid', ), 'next' => array ( 0 => 'function.posix-getgroups.php', 1 => 'posix_getgroups', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/posix/functions/posix-getgrnam.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

posix_getgrnam

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

posix_getgrnam — Retorna 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

Exemplo #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