PHP posix_getpwnam 系统接口函数

  • 定义和用法

    posix_getpwnam - 按用户名返回有关用户的信息
  • 版本支持

    PHP4 PHP5 PHP7
    支持 支持 支持
  • 语法

    posix_getpwnam( string $username )
    posix_getpwnam() 返回有关给定用户的信息数组。
  • 参数

    参数 必需的 描述
    username 字母数字用户名。
  • 返回值

    成功后,将返回具有以下元素的数组,否则返回FALSE:
    • name - name元素包含用户的用户名。这是用户的简称,通常少于16个字符,而不是真实的全名。此名称应与调用函数时使用的username参数相同,因此是多余的。
    • passwd - passwd元素包含加密格式的用户密码。通常,例如在使用“影子”密码的系统上,将返回星号。
    • uid - 数字形式的用户的用户标识。
    • gid - 用户的组ID。使用函数posix_getgrgid()解析组名及其成员列表。
    • gecos - GECOS是一个过时的术语,指的是Honeywell批处理系统上的手指信息字段。但是,该领域仍然存在,并且其内容已由POSIX正式确定。该字段包含一个用逗号分隔的列表,其中包含用户的全名,办公室电话,办公室号码和家庭电话号码。在大多数系统上,仅用户的全名可用。
    • dir - 该元素包含用户主目录的绝对路径。
    • shell - shell元素包含用户默认Shell的可执行文件的绝对路径。
  • 示例

    $userinfo = posix_getpwnam("tom");
    
    print_r($userinfo); 
    
    示例输出类似如下:
    Array
    (
        [name]    => tom
        [passwd]  => x
        [uid]     => 10000
        [gid]     => 42
        [gecos]   => "tom,,,"
        [dir]     => "/home/tom"
        [shell]   => "/bin/bash"
    )
    
  • 相关页面

    posix_getpwuid() - 通过用户ID返回有关用户的信息