mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-18 05:26:57 +08:00
184 lines
5.9 KiB
HTML
184 lines
5.9 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
|
<title>Return info about a user by username</title>
|
|
</head>
|
|
<body class="docs"><div id="layout">
|
|
<div id="layout-content"><div id="function.posix-getpwnam" class="refentry">
|
|
<div class="refnamediv">
|
|
<h1 class="refname">posix_getpwnam</h1>
|
|
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">posix_getpwnam</span> — <span class="dc-title">Return info about a user by username</span></p>
|
|
|
|
</div>
|
|
|
|
<div class="refsect1 description" id="refsect1-function.posix-getpwnam-description">
|
|
<h3 class="title">说明</h3>
|
|
<div class="methodsynopsis dc-description">
|
|
<span class="methodname"><strong>posix_getpwnam</strong></span>
|
|
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$username</code></span>
|
|
) : <span class="type">array</span></div>
|
|
|
|
<p class="para rdfs-comment">
|
|
Returns an <span class="type"><a href="language.types.array.html" class="type array">array</a></span> of information about the given user.
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 parameters" id="refsect1-function.posix-getpwnam-parameters">
|
|
<h3 class="title">参数</h3>
|
|
<p class="para">
|
|
<dl>
|
|
|
|
|
|
<dt>
|
|
<code class="parameter">username</code></dt>
|
|
|
|
<dd>
|
|
|
|
<p class="para">
|
|
An alphanumeric username.
|
|
</p>
|
|
</dd>
|
|
|
|
|
|
</dl>
|
|
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 returnvalues" id="refsect1-function.posix-getpwnam-returnvalues">
|
|
<h3 class="title">返回值</h3>
|
|
<p class="para">
|
|
On success an array with the following elements is returned, else
|
|
<strong><code>FALSE</code></strong> is returned:
|
|
<table class="doctable table">
|
|
<caption><strong>The user information array</strong></caption>
|
|
|
|
<thead>
|
|
<tr>
|
|
<th>Element</th>
|
|
<th>Description</th>
|
|
</tr>
|
|
|
|
</thead>
|
|
|
|
<tbody class="tbody">
|
|
<tr>
|
|
<td>name</td>
|
|
<td>
|
|
The name element contains the username of the user. This is
|
|
a short, usually less than 16 character "handle" of the
|
|
user, not the real, full name. This should be the same as
|
|
the <code class="parameter">username</code> parameter used when
|
|
calling the function, and hence redundant.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>passwd</td>
|
|
<td>
|
|
The passwd element contains the user's password in an
|
|
encrypted format. Often, for example on a system employing
|
|
"shadow" passwords, an asterisk is returned instead.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>uid</td>
|
|
<td>
|
|
User ID of the user in numeric form.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>gid</td>
|
|
<td>
|
|
The group ID of the user. Use the function
|
|
<span class="function"><a href="posix_getgrgid.html" class="function">posix_getgrgid()</a></span> to resolve the group
|
|
name and a list of its members.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>gecos</td>
|
|
<td>
|
|
GECOS is an obsolete term that refers to the finger
|
|
information field on a Honeywell batch processing system.
|
|
The field, however, lives on, and its contents have been
|
|
formalized by POSIX. The field contains a comma separated
|
|
list containing the user's full name, office phone, office
|
|
number, and home phone number. On most systems, only the
|
|
user's full name is available.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>dir</td>
|
|
<td>
|
|
This element contains the absolute path to the home
|
|
directory of the user.
|
|
</td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td>shell</td>
|
|
<td>
|
|
The shell element contains the absolute path to the
|
|
executable of the user's default shell.
|
|
</td>
|
|
</tr>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 examples" id="refsect1-function.posix-getpwnam-examples">
|
|
<h3 class="title">范例</h3>
|
|
<p class="para">
|
|
<div class="example" id="example-4345">
|
|
<p><strong>Example #1 Example use of <span class="function"><strong>posix_getpwnam()</strong></span></strong></p>
|
|
<div class="example-contents">
|
|
<div class="phpcode"><pre><span style="color: #000000">
|
|
<span style="color: #0000BB"><?php<br /><br />$userinfo </span><span style="color: #007700">= </span><span style="color: #0000BB">posix_getpwnam</span><span style="color: #007700">(</span><span style="color: #DD0000">"tom"</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$userinfo</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
|
|
</span>
|
|
</pre></div>
|
|
</div>
|
|
|
|
<div class="example-contents"><p>以上例程的输出类似于：</p></div>
|
|
<div class="example-contents screen">
|
|
<div class="cdata"><pre>
|
|
Array
|
|
(
|
|
[name] => tom
|
|
[passwd] => x
|
|
[uid] => 10000
|
|
[gid] => 42
|
|
[gecos] => "tom,,,"
|
|
[dir] => "/home/tom"
|
|
[shell] => "/bin/bash"
|
|
)
|
|
</pre></div>
|
|
</div>
|
|
</div>
|
|
</p>
|
|
</div>
|
|
|
|
|
|
<div class="refsect1 seealso" id="refsect1-function.posix-getpwnam-seealso">
|
|
<h3 class="title">参见</h3>
|
|
<p class="para">
|
|
<ul class="simplelist">
|
|
<li class="member"><span class="function"><a href="posix_getpwuid.html" class="function" rel="rdfs-seeAlso">posix_getpwuid()</a> - Return info about a user by user id</span></li>
|
|
<li class="member">POSIX man page GETPWNAM(3)</li>
|
|
</ul>
|
|
</p>
|
|
</div>
|
|
|
|
|
|
</div></div></div></body></html> |