uTools-Manuals/docs/php/ftp_mlsd.html
2019-04-08 23:22:26 +08:00

194 lines
7.3 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>Returns a list of files in the given directory</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.ftp-mlsd" class="refentry">
<div class="refnamediv">
<h1 class="refname">ftp_mlsd</h1>
<p class="verinfo">(PHP 7 &gt;= 7.2.0)</p><p class="refpurpose"><span class="refname">ftp_mlsd</span> &mdash; <span class="dc-title">Returns a list of files in the given directory</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.ftp-mlsd-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>ftp_mlsd</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$ftp_stream</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$directory</code></span>
) : <span class="type">array</span></div>
</div>
<div class="refsect1 parameters" id="refsect1-function.ftp-mlsd-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">ftp_stream</code></dt>
<dd>
<p class="para">
The link identifier of the FTP connection.
</p>
</dd>
<dt>
<code class="parameter">directory</code></dt>
<dd>
<p class="para">
The directory to be listed.
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.ftp-mlsd-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
Returns an array of arrays with file infos from the specified directory on success or
<strong><code>FALSE</code></strong> on error.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.ftp-mlsd-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-5317">
<p><strong>Example #1 <span class="function"><strong>ftp_mlsd()</strong></span> example</strong></p>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">//&nbsp;set&nbsp;up&nbsp;basic&nbsp;connection<br /></span><span style="color: #0000BB">$conn_id&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">ftp_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">$ftp_server</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;login&nbsp;with&nbsp;username&nbsp;and&nbsp;password<br /></span><span style="color: #0000BB">$login_result&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">ftp_login</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_id</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$ftp_user_name</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$ftp_user_pass</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;get&nbsp;contents&nbsp;of&nbsp;the&nbsp;current&nbsp;directory<br /></span><span style="color: #0000BB">$contents&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">ftp_mlsd</span><span style="color: #007700">(</span><span style="color: #0000BB">$conn_id</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">"."</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;output&nbsp;$contents<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$contents</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
<div class="example-contents"><p>以上例程的输出类似于:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
array(5) {
[0]=&gt;
array(8) {
[&quot;name&quot;]=&gt;
string(1) &quot;.&quot;
[&quot;modify&quot;]=&gt;
string(14) &quot;20171212154511&quot;
[&quot;perm&quot;]=&gt;
string(7) &quot;flcdmpe&quot;
[&quot;type&quot;]=&gt;
string(4) &quot;cdir&quot;
[&quot;unique&quot;]=&gt;
string(11) &quot;811U5740002&quot;
[&quot;UNIX.group&quot;]=&gt;
string(2) &quot;33&quot;
[&quot;UNIX.mode&quot;]=&gt;
string(4) &quot;0755&quot;
[&quot;UNIX.owner&quot;]=&gt;
string(2) &quot;33&quot;
}
[1]=&gt;
array(8) {
[&quot;name&quot;]=&gt;
string(2) &quot;..&quot;
[&quot;modify&quot;]=&gt;
string(14) &quot;20171212154511&quot;
[&quot;perm&quot;]=&gt;
string(7) &quot;flcdmpe&quot;
[&quot;type&quot;]=&gt;
string(4) &quot;pdir&quot;
[&quot;unique&quot;]=&gt;
string(11) &quot;811U5740002&quot;
[&quot;UNIX.group&quot;]=&gt;
string(2) &quot;33&quot;
[&quot;UNIX.mode&quot;]=&gt;
string(4) &quot;0755&quot;
[&quot;UNIX.owner&quot;]=&gt;
string(2) &quot;33&quot;
}
[2]=&gt;
array(8) {
[&quot;name&quot;]=&gt;
string(11) &quot;public_html&quot;
[&quot;modify&quot;]=&gt;
string(14) &quot;20171211171525&quot;
[&quot;perm&quot;]=&gt;
string(7) &quot;flcdmpe&quot;
[&quot;type&quot;]=&gt;
string(3) &quot;dir&quot;
[&quot;unique&quot;]=&gt;
string(11) &quot;811U5740525&quot;
[&quot;UNIX.group&quot;]=&gt;
string(2) &quot;33&quot;
[&quot;UNIX.mode&quot;]=&gt;
string(4) &quot;0755&quot;
[&quot;UNIX.owner&quot;]=&gt;
string(2) &quot;33&quot;
}
[3]=&gt;
array(8) {
[&quot;name&quot;]=&gt;
string(10) &quot;public_ftp&quot;
[&quot;modify&quot;]=&gt;
string(14) &quot;20171211174536&quot;
[&quot;perm&quot;]=&gt;
string(7) &quot;flcdmpe&quot;
[&quot;type&quot;]=&gt;
string(3) &quot;dir&quot;
[&quot;unique&quot;]=&gt;
string(11) &quot;811U57405EE&quot;
[&quot;UNIX.group&quot;]=&gt;
string(2) &quot;33&quot;
[&quot;UNIX.mode&quot;]=&gt;
string(4) &quot;0755&quot;
[&quot;UNIX.owner&quot;]=&gt;
string(2) &quot;33&quot;
}
[4]=&gt;
array(8) {
[&quot;name&quot;]=&gt;
string(3) &quot;www&quot;
[&quot;modify&quot;]=&gt;
string(14) &quot;www&quot;
[&quot;perm&quot;]=&gt;
string(7) &quot;flcdmpe&quot;
[&quot;type&quot;]=&gt;
string(3) &quot;dir&quot;
[&quot;unique&quot;]=&gt;
string(11) &quot;811U5740780&quot;
[&quot;UNIX.group&quot;]=&gt;
string(2) &quot;33&quot;
[&quot;UNIX.mode&quot;]=&gt;
string(4) &quot;0755&quot;
[&quot;UNIX.owner&quot;]=&gt;
string(2) &quot;33&quot;
}
}
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.ftp-mlsd-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="ftp_rawlist.html" class="function" rel="rdfs-seeAlso">ftp_rawlist()</a> - 返回指定目录下文件的详细列表</span></li>
<li class="member"><span class="function"><a href="ftp_nlist.html" class="function" rel="rdfs-seeAlso">ftp_nlist()</a> - 返回给定目录的文件列表</span></li>
</ul>
</p>
</div>
</div></div></div></body></html>