com doc/zh: 同步并翻译 ftp -size.xml: reference/ftp/functions/ftp-size.xml

Commit:    31e46469fa5855408f20fb9063c1b3892d402c37
Author:    蒋文健 <[email protected]>         Tue, 19 Jan 2021 21:37:58 +0800
Committer: daijie <[email protected]>      Fri, 22 Jan 2021 20:18:09 +0800
Parents:   f7a62fd5ba5bfd6e93dec69ea1e0cf4e523b582e
Branches:  master

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

Log:
同步并翻译 ftp-size.xml

Changed paths:
  M  reference/ftp/functions/ftp-size.xml


Diff:
diff --git a/reference/ftp/functions/ftp-size.xml b/reference/ftp/functions/ftp-size.xml
index 12adf5e5..d4d2db69 100644
--- a/reference/ftp/functions/ftp-size.xml
+++ b/reference/ftp/functions/ftp-size.xml
@@ -1,101 +1,93 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: Avenger Status: ready -->
-  <refentry xml:id="function.ftp-size" xmlns="http://docbook.org/ns/docbook">
-   <refnamediv>
-    <refname>ftp_size</refname>
-    <refpurpose>返回指定文件的大小</refpurpose>
-   </refnamediv>
-   <refsect1 role="description">
-    &reftitle.description;
-    <methodsynopsis>
-     <type>int</type><methodname>ftp_size</methodname>
-     <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam>
-     <methodparam><type>string</type><parameter>remote_file</parameter></methodparam>
-    </methodsynopsis>
-    <para>
-     <function>ftp_size</function> 函数以字节返回远程文件
-     <parameter>remote_file</parameter> 的大小。如果指定文件不存在或发生错误，则返回
-     -1。有些 FTP 服务器可能不支持此特性。
-    </para>
-    <note>
-     <para>
-      获取成功返回文件大小，否则返回 -1。
-     </para> 
-    </note>
-   </refsect1>
-   <refsect1 role="parameters">
-    &reftitle.parameters;
-    <para>
-     <variablelist>
-      <varlistentry>
-       <term><parameter>ftp_stream</parameter></term>
-       <listitem>
-        <para>
-         FTP 连接资源。
-        </para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-       <term><parameter>remote_file</parameter></term>
-       <listitem>
-        <para>
-         远程文件。
-        </para>
-       </listitem>
-      </varlistentry>
-     </variablelist>
-    </para>
-   </refsect1>
-   <refsect1 role="returnvalues">
-   &reftitle.returnvalues;
+<!-- EN-Revision: 18680fd1681731888c6fb7c530cfdb712f53e954 Maintainer: Avenger Status: ready -->
+<refentry xml:id="function.ftp-size" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>ftp_size</refname>
+  <refpurpose>返回指定文件的大小</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>int</type><methodname>ftp_size</methodname>
+   <methodparam><type>resource</type><parameter>ftp</parameter></methodparam>
+   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   <function>ftp_size</function> 函数返回指定文件的大小（以字节为单位）。
+  </para>
+  <note>
    <para>
-    执行成功返回文件大小，失败返回 -1。
+    不是所有服务器都支持该功能。
    </para>
-   </refsect1>
-   <refsect1 role="examples">
-    &reftitle.examples;
-     <para>
-     <example>
-      <title><function>ftp_size</function> 例子</title>
-      <programlisting role="php">
+  </note>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>ftp</parameter></term>
+     <listitem>
+      <para>
+       FTP 连接的链接标识符。
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>filename</parameter></term>
+     <listitem>
+      <para>
+       远程文件。
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   成功时返回文件大小，错误返回 -1 。
+  </para>
+ </refsect1>
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>ftp_size</function> example</title>
+    <programlisting role="php">
 <![CDATA[
 <?php
 $file = 'somefile.txt';
-
-// set up basic connection 
+// 简单基本连接
 $conn_id = ftp_connect($ftp_server);
-
-// login with username and password
+// 使用用户名和密码进行登录
 $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);
-
-// get the size of $file
+// 获取 $file 文件大小
 $res = ftp_size($conn_id, $file);
-
 if ($res != -1) {
     echo "size of $file is $res bytes";
 } else {
     echo "couldn't get the size";
 }
-
-//close the conntion
+// 关闭连接
 ftp_close($conn_id);
 ?>
 ]]>
-      </programlisting>
-     </example>
-    </para>
-   </refsect1>
-   <refsect1 role="seealso">
-   &reftitle.seealso;
-   <para>
-    <simplelist>
-     <member><function>ftp_rawlist</function></member>
-    </simplelist>
-   </para>
-   </refsect1>
-  </refentry>
-
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>ftp_rawlist</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml