# posix_getgrnam

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

posix_getgrnam — Devolver información sobre un grupo mediante su nombre

### Descripción

posix_getgrnam(string `$name`): array

Obtiene información sobre un grupo, proporcioinado su nombre.

### Parámetros

`name`

  EL nombre del grupo

### Valores devueltos

Los elementos del array devuelto son:

El array de información del grupo
Elemento | Descripción
--- | ---
name | El elemento name contiene el nombre del grupo. Es una abreviatura, normalmente menos de 16 caracteres "soportan" el groupo, no el nombre real completo. Debería ser el mismo que el del parámetro `name` usado al llamar a la función, y por lo tanto redundante.
passwd | El elemento passwd contiene la contraseña del grupo en un formato encriptado. A menudo, por ejemplo bajo un sistema que emplea contraseñas "shadow", se devuelve un asterisco en su lugar.
gid | El ID del grupo en forma numérica.
members | Consiste en un array de strings de todos los miembros del grupo.

### Ejemplos

Ejemplo #1 Ejemplo de uso de posix_getgrnam()

`<?php
$groupinfo = posix_getgrnam("toons");
print_r($groupinfo);
?>`

El resultado del ejemplo sería algo similar a:

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

### Ver también

- posix_getegid() - Devuelve el ID efectivo de grupo del proceso actual
- posix_getgrgid() - Devolver información sobre un grupo mediante un id de grupo
- filegroup() - Obtiene el grupo de un archivo
- stat() - Da información acerca de un fichero
- POSIX man page GETGRNAM(3)