函式名稱:posix_getpwnam()
函式描述:posix_getpwnam() 函式根據使用者名稱獲取關於使用者的資訊。
適用版本:PHP 4, PHP 5, PHP 7
語法:
posix_getpwnam(string $username): array|false
引數:
- $username:要獲取資訊的使用者名稱。
返回值:
- 成功時,返回一個包含關於使用者的資訊的關聯陣列。陣列的鍵名如下:
- name:使用者名稱
- passwd:使用者密碼
- uid:使用者ID
- gid:使用者組ID
- gecos:使用者全名
- dir:使用者主目錄
- shell:使用者登入時使用的shell
- 如果未找到使用者,則返回 false。
示例:
$username = 'john';
$userInfo = posix_getpwnam($username);
if ($userInfo !== false) {
echo "使用者名稱:" . $userInfo['name'] . "\n";
echo "密碼:" . $userInfo['passwd'] . "\n";
echo "使用者ID:" . $userInfo['uid'] . "\n";
echo "使用者組ID:" . $userInfo['gid'] . "\n";
echo "使用者全名:" . $userInfo['gecos'] . "\n";
echo "使用者主目錄:" . $userInfo['dir'] . "\n";
echo "使用者登入時使用的shell:" . $userInfo['shell'] . "\n";
} else {
echo "未找到使用者:" . $username . "\n";
}
注意事項:
- 該函式在 Windows 平臺上不可用。
- 使用該函式需要擁有足夠的許可權。
- 如果使用者不存在或發生錯誤,函式將返回 false。因此,在使用返回值之前,應該使用
!== false
進行判斷。