com doc/zh: 添加 ftp-mlsd.xml 文 件: reference/ftp/functions/ftp-mlsd.xml

Commit:    d4ffbf959ab8c237d09482bb8c3e4b8bf2295de7
Author:    蒋文健 <[email protected]>         Tue, 19 Jan 2021 21:04:32 +0800
Committer: daijie <[email protected]>      Fri, 22 Jan 2021 20:18:09 +0800
Parents:   bede9b06ef7fcfd6d6457e953f0efeb39ff23c80
Branches:  master

Link:       http://git.php.net/?p=doc/zh.git;a=commitdiff;h=d4ffbf959ab8c237d09482bb8c3e4b8bf2295de7

Log:
添加 ftp-mlsd.xml 文件

对应英文文件：https://github.com/php/doc-en/blob/master/reference/ftp/functions/ftp-mlsd.xml

Changed paths:
  A  reference/ftp/functions/ftp-mlsd.xml


Diff:
diff --git a/reference/ftp/functions/ftp-mlsd.xml b/reference/ftp/functions/ftp-mlsd.xml
new file mode 100644
index 00000000..9662eaac
--- /dev/null
+++ b/reference/ftp/functions/ftp-mlsd.xml
@@ -0,0 +1,200 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 18680fd1681731888c6fb7c530cfdb712f53e954 Status: ready -->
+<refentry xml:id="function.ftp-mlsd" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>ftp_mlsd</refname>
+  <refpurpose>返回指定目录中的文件列表</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>array</type><type>false</type></type><methodname>ftp_mlsd</methodname>
+   <methodparam><type>resource</type><parameter>ftp</parameter></methodparam>
+   <methodparam><type>string</type><parameter>directory</parameter></methodparam>
+  </methodsynopsis>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>ftp</parameter></term>
+     <listitem>
+      <para>
+       FTP 连接的链接标识符。
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>directory</parameter></term>
+     <listitem>
+      <para>
+       要列出的目录。
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   如果成功，则返回目录中包含文件信息的数组的数组；
+   如果错误，则返回 &false; 。
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>ftp_mlsd</function> 示例</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// 简历基本连接
+$conn_id = ftp_connect($ftp_server);
+// 使用用户名和密码进行登录
+$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
+// 获取当前目录的内容
+$contents = ftp_mlsd($conn_id, ".");
+// 输出 $contents
+var_dump($contents);
+?>
+]]>  
+    </programlisting>
+    &example.outputs.similar;
+    <screen>
+<![CDATA[
+array(5) {
+  [0]=>
+  array(8) {
+    ["name"]=>
+    string(1) "."
+    ["modify"]=>
+    string(14) "20171212154511"
+    ["perm"]=>
+    string(7) "flcdmpe"
+    ["type"]=>
+    string(4) "cdir"
+    ["unique"]=>
+    string(11) "811U5740002"
+    ["UNIX.group"]=>
+    string(2) "33"
+    ["UNIX.mode"]=>
+    string(4) "0755"
+    ["UNIX.owner"]=>
+    string(2) "33"
+  }
+  [1]=>
+  array(8) {
+    ["name"]=>
+    string(2) ".."
+    ["modify"]=>
+    string(14) "20171212154511"
+    ["perm"]=>
+    string(7) "flcdmpe"
+    ["type"]=>
+    string(4) "pdir"
+    ["unique"]=>
+    string(11) "811U5740002"
+    ["UNIX.group"]=>
+    string(2) "33"
+    ["UNIX.mode"]=>
+    string(4) "0755"
+    ["UNIX.owner"]=>
+    string(2) "33"
+  }
+  [2]=>
+  array(8) {
+    ["name"]=>
+    string(11) "public_html"
+    ["modify"]=>
+    string(14) "20171211171525"
+    ["perm"]=>
+    string(7) "flcdmpe"
+    ["type"]=>
+    string(3) "dir"
+    ["unique"]=>
+    string(11) "811U5740525"
+    ["UNIX.group"]=>
+    string(2) "33"
+    ["UNIX.mode"]=>
+    string(4) "0755"
+    ["UNIX.owner"]=>
+    string(2) "33"
+  }
+  [3]=>
+  array(8) {
+    ["name"]=>
+    string(10) "public_ftp"
+    ["modify"]=>
+    string(14) "20171211174536"
+    ["perm"]=>
+    string(7) "flcdmpe"
+    ["type"]=>
+    string(3) "dir"
+    ["unique"]=>
+    string(11) "811U57405EE"
+    ["UNIX.group"]=>
+    string(2) "33"
+    ["UNIX.mode"]=>
+    string(4) "0755"
+    ["UNIX.owner"]=>
+    string(2) "33"
+  }
+  [4]=>
+  array(8) {
+    ["name"]=>
+    string(3) "www"
+    ["modify"]=>
+    string(14) "www"
+    ["perm"]=>
+    string(7) "flcdmpe"
+    ["type"]=>
+    string(3) "dir"
+    ["unique"]=>
+    string(11) "811U5740780"
+    ["UNIX.group"]=>
+    string(2) "33"
+    ["UNIX.mode"]=>
+    string(4) "0755"
+    ["UNIX.owner"]=>
+    string(2) "33"
+  }
+}
+]]>
+    </screen>
+   </example>
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>ftp_rawlist</function></member>
+    <member><function>ftp_nlist</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->