CascadiaPHP 2024


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

posix_getgrnamReturn info about a group by name


posix_getgrnam(string $name): array|false

Gets information about a group provided its name.



The name of the group

Valor Retornado

Returns an array on success, ou false em caso de falha. The array elements returned are:

The group information array
Element Description
name The name element contains the name of the group. This is a short, usually less than 16 character "handle" of the group, not the real, full name. This should be the same as the name parameter used when calling the function, and hence redundant.
passwd The passwd element contains the group's password in an encrypted format. Often, for example on a system employing "shadow" passwords, an asterisk is returned instead.
gid Group ID of the group in numeric form.
members This consists of an array of string's for all the members in the group.


Exemplo #1 Example use of posix_getgrnam()


= posix_getgrnam("toons");


O exemplo acima produzirá algo semelhante a:

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

Veja Também

  • posix_getegid() - Return the effective group ID of the current process
  • posix_getgrgid() - Return info about a group by group id
  • filegroup() - Lê o grupo do arquivo
  • stat() - Obtém informações sobre um arquivo
  • POSIX man page GETGRNAM(3)

add a note

User Contributed Notes 1 note

marques at displague dot com
15 years ago
This function returns 'false' if the group is not found.
To Top