# posix_getgrnam

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

posix_getgrnam — Return info about a group by name

### 说明

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

Gets information about a group provided its name.

### 参数

`name`

  The name of the group

### 返回值

Returns an array on success, 或者在失败时返回 `false`. 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.

### 示例

示例 #1 Example use of posix_getgrnam()

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

以上示例的输出类似于：

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

### 参见

- posix_getegid() - Return the effective group ID of the current process
- posix_getgrgid() - Return info about a group by group id
- filegroup() - 取得文件的组
- stat() - 给出文件的信息
- POSIX man page GETGRNAM(3)

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