com doc/zh: 添加 ftp-mlsd.xml 文 件: reference/ftp/functions/ftp-mlsd.xml
| From: | Dai Jie | Date: | Fri, 22 Jan 2021 12:18:09 +0000 |
| Subject: | com doc/zh: 添加 ftp-mlsd.xml 文 件: reference/ftp/functions/ftp-mlsd.xml | ||
| Groups: | php.doc.zh | ||
| Request: | Send a blank email to doc-zh+get-5940@lists.php.net to get a copy of this message | ||
Commit: d4ffbf959ab8c237d09482bb8c3e4b8bf2295de7
Author: 蒋文健 <jwjbjg@gmail.com> Tue, 19 Jan 2021 21:04:32 +0800
Committer: daijie <daijie@php.net> 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
+-->