Documentación offline PHP master

posix_getgrnam

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

posix_getgrnam

Devolver información sobre un grupo mediante su nombre

Descripción#

posix_getgrnam(string $name): array
```php

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

## Parámetros

`name`  
EL nombre del grupo

## Valores devueltos

Los elementos del array devuelto son:

| 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 `string`s de todos los miembros del grupo. |

El array de información del grupo

## Ejemplos

Ejemplo de uso de `posix_getgrnam`

```php

Resultado del ejemplo anterior es similar a:

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

Véase también#

posix_getegid, posix_getgrgid, filegroup, stat, Página GETGRNAM(3) del man de POSIX