posix_getgrnam
PHP function
Edit on GitHub ✎
(PHP 4, PHP 5, PHP 7, PHP 8)
Return info about a group by name
Description
posix_getgrnam(string $name): array|false
Gets information about a group provided its name.
Parameters
nameThe name of the group
Return Values
Returns an array on success, Falseforfailure. 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. |
Examples
Example use of posix_getgrnam()
php
<?php
$groupinfo = posix_getgrnam("toons");
print_r($groupinfo);
?>The above example will output something similar to:
output
Array
(
[name] => toons
[passwd] => x
[members] => Array
(
[0] => tom
[1] => jerry
)
[gid] => 42
)See Also
posix_getegid()posix_getgrgid()filegroup()stat()- POSIX man page GETGRNAM(3)