com doc/zh: 同步并翻译 ftp -size.xml: reference/ftp/functions/ftp-size.xml
| From: | Dai Jie | Date: | Fri, 22 Jan 2021 12:18:09 +0000 |
| Subject: | com doc/zh: 同步并翻译 ftp -size.xml: reference/ftp/functions/ftp-size.xml | ||
| Groups: | php.doc.zh | ||
| Request: | Send a blank email to doc-zh+get-5934@lists.php.net to get a copy of this message | ||
Commit: 31e46469fa5855408f20fb9063c1b3892d402c37
Author: 蒋文健 <jwjbjg@gmail.com> Tue, 19 Jan 2021 21:37:58 +0800
Committer: daijie <daijie@php.net> 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