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

# posix_getgrnam

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

posix_getgrnam — Retorna informação sobre um grupo a partir do nome

### Descrição

function 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

- 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open