# posix_getgrnam

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

posix_getgrnam — Retourne des informations sur un groupe

### Description

posix_getgrnam(string `$name`): array|false

Récupère les informations d'un groupe donné.

### Liste de paramètres

`name`

  Le nom du groupe

### Valeurs de retour

Retourne un tableau en cas de succès, ou `false` si une erreur survient. Les éléments du tableau retourné sont :

Les informations du groupe
Élément | Description
--- | ---
name | Cet élément contient le nom du groupe. C'est un nom abrégé, habituellement, contenant moins de 16 caractères. C'est le même que le paramètre `name` utilisé lors de l'appel à la fonction.
passwd | Cet élément contient le mot de passe du groupe, crypté. Par exemple, sous un système utilisant les mots de passes "shadow", un astérisque est retourné.
gid | L'ID du groupe, sous un format numérique.
members | C'est un tableau de chaînes de caractères pour tous les membres du groupe.

### Exemples

Exemple #1 Exemple avec posix_getgrnam()

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

Résultat de l'exemple ci-dessus est similaire à :

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

### Voir aussi

- posix_getegid() - Retourne l'ID effectif du groupe du processus courant
- posix_getgrgid() - Retourne des informations sur un groupe
- filegroup() - Lire le nom du groupe
- stat() - Renvoie les informations à propos d'un fichier
- POSIX man page GETGRNAM(3)