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返回有关用户的信息