posix_getgrnam
(PHP 4, PHP 5, PHP 7, PHP 8)
posix_getgrnam — Return info about a group by name
說明
posix_getgrnam(string
$name): array|falseGets information about a group provided its name.
參數
-
name -
The name of the group
返回值
Returns an array on success, 或者在失敗時返回 false.
The array elements returned are:
| 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)