Ftp


>i 本文档的最新修订日期是: > **2020-12-27** # Ftp ## 模块简述 通过FTP进行上传、下载等操作。 ## 模块配置 配置文件位于 `/Config/Ftp.php` 。 * **`Server`** `(String)` `''` : 指定FTP连接地址。 * **`Port`** `(Int)` `21` : 指定远程服务器的FTP服务的端口。 * **`User`** `(String)` `''` : 指定连接FTP时提供的用户名。 * **`Password`** `(String)` `''` : 指定连接FTP时提供的密码。 ## 公共参数 * **`timeout(超时时间)`** `(Int)` `默认值见方法参数`: 用以指定超时时间。 值的单位为秒(s)。 ## :: Up()方法 ### 语法 **Ftp :: Up ( 传参数组 ) ** ### 说明 将一个文件通过FTP上传到远程服务器上的指定的位置。 此方法 `支持` 中文参数名。 ### 参数 * **`from(本地路径)`** `(String)` `<必须>`: 指定需要上传的文件路径,值为相对于 `应用根目录` (即Core、Source文件夹所在的目录,通常是站点根目录)的路径,以 `/` 开始。 * **`to(远程路径)`** `(String)` `<必须>`: 指定上传的文件在远程符服务器存储的路径。 * **`timeout(连接信息)`** `(Int)` `90`: 详见本模块 `公共参数` 部分的说明。 ### 返回 `(Bool)` 类型。 返回值为 `TRUE` 时代表操作成功完成、`FALSE` 代表操作失败。 ## :: Down()方法 ### 语法 **Ftp :: Down ( 传参数组 )** ### 说明 将远程服务器上的一个文件通过FTP下载到指定的位置。 此方法 `支持` 中文参数名。 ### 参数 * **`from(远程路径)`** `(String)` `<必须>`: 指定需要下载的文件在远程服务器上的存储路径。 * **`to(本地路径)`** `(String)` `<必须>`: 指定将下载的文件存储到何处,值为相对于 `应用根目录` (即Core、Source文件夹所在的目录,通常是站点根目录)的路径,以 `/` 开始。 * **`timeout(连接信息)`** `(Int)` `90`: 详见本模块 `公共参数` 部分的说明。 ### 返回 `(Bool)` 类型。 返回值为 `TRUE` 时代表操作成功完成、`FALSE` 代表操作失败。