如果找不到群組,此函數會返回 'false'。
(PHP 4, PHP 5, PHP 7, PHP 8)
posix_getgrnam — 依群組名稱返回群組資訊
name
群組的名稱
成功時返回 array,失敗時返回 false
。返回的陣列元素為
元素 | 描述 |
---|---|
name | name 元素包含群組的名稱。這是一個簡短的、通常少於 16 個字元的群組「代號」,而非真實的完整名稱。這應該與呼叫函數時使用的 name 參數相同,因此是多餘的。 |
passwd | passwd 元素包含群組的加密密碼。通常,例如在使用「陰影」密碼的系統上,會返回星號代替。 |
gid | 群組的數字形式 ID。 |
members | 這包含群組中所有成員的 string 類型的 array。 |
範例 #1 posix_getgrnam() 的使用範例
<?php
$groupinfo = posix_getgrnam("toons");
print_r($groupinfo);
?>
上述範例將輸出類似以下內容
Array ( [name] => toons [passwd] => x [members] => Array ( [0] => tom [1] => jerry ) [gid] => 42 )