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.

范例

Example #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)

User Contributed Notes

marques at displague dot com 02-Apr-2009 06:12


This function returns 'false' if the group is not found.