# FTP 类
CodeIgniter 的 FTP 类允许你传输文件至远程服务器，也可以对远程文件进行移动、重命名或删除操作。 FTP 类还提供了一个 "镜像" 功能，允许你将你本地的一个目录通过 FTP 整个的同步到远程服务器上。
注解
只支持标准的 FTP 协议，不支持 SFTP 和 SSL FTP 。
[TOC=2,3]
## 使用 FTP 类
### 初始化类
正如 CodeIgniter 中的其他类一样，在你的控制器中使用 $this->load->library() 方法来初始化 FTP 类:
~~~
$this->load->library('ftp');
~~~
初始化之后，FTP 类的对象就可以这样访问:
~~~
$this->ftp
~~~
### 使用示例
在这个例子中，首先建立一个到 FTP 服务器的连接，接着读取一个本地文件然后以 ASCII 模式上传到服务器上。文件的权限被设置为 755 。
~~~
$this->load->library('ftp');
$config['hostname'] = 'ftp.example.com';
$config['username'] = 'your-username';
$config['password'] = 'your-password';
$config['debug'] = TRUE;
$this->ftp->connect($config);
$this->ftp->upload('/local/path/to/myfile.html', '/public_html/myfile.html', 'ascii', 0775);
$this->ftp->close();
~~~
下面的例子从 FTP 服务器上获取文件列表。
~~~
$this->load->library('ftp');
$config['hostname'] = 'ftp.example.com';
$config['username'] = 'your-username';
$config['password'] = 'your-password';
$config['debug'] = TRUE;
$this->ftp->connect($config);
$list = $this->ftp->list_files('/public_html/');
print_r($list);
$this->ftp->close();
~~~
下面的例子在 FTP 服务器上创建了一个本地目录的镜像。
~~~
$this->load->library('ftp');
$config['hostname'] = 'ftp.example.com';
$config['username'] = 'your-username';
$config['password'] = 'your-password';
$config['debug'] = TRUE;
$this->ftp->connect($config);
$this->ftp->mirror('/path/to/myfolder/', '/public_html/myfolder/');
$this->ftp->close();
~~~
## 类参考
classCI_FTP
>[info] ### connect([$config = array()])
参数:
* **$config** (array) -- Connection values
返回: TRUE on success, FALSE on failure
返回类型: bool
连接并登录到 FTP 服务器，通过向函数传递一个数组来设置连接参数，或者你可以把这些参数保存在一个配置文件中。
下面例子演示了如何手动设置参数:
~~~
$this->load->library('ftp');
$config['hostname'] = 'ftp.example.com';
$config['username'] = 'your-username';
$config['password'] = 'your-password';
$config['port'] = 21;
$config['passive'] = FALSE;
$config['debug'] = TRUE;
$this->ftp->connect($config);
~~~
**在配置文件中设置 FTP 参数**
如果你喜欢，你可以把 FTP 参数保存在一个配置文件中，只需创建一个名为 ftp.php 的文件， 然后把 $config 数组添加到该文件中，然后将文件保存到 application/config/ftp.php ， 它就会自动被读取。
**可用的连接选项**
| 选项名称 | 默认值 | 描述 |
| --- | --- | --- |
| **hostname** | n/a | FTP 主机名（通常类似于这样：ftp.example.com） |
| **username** | n/a | FTP 用户名 |
| **password** | n/a | FTP 密码 |
| **port** | 21 | FTP 服务端口 |
| **debug** | FALSE | TRUE/FALSE (boolean): 是否开启调试模式，显示错误信息 |
| **passive** | TRUE | TRUE/FALSE (boolean): 是否使用被动模式 |
>[info] ### upload($locpath, $rempath[, $mode = 'auto'[, $permissions = NULL]])
参数:
* **$locpath** (string) -- Local file path
* **$rempath** (string) -- Remote file path
* **$mode** (string) -- FTP mode, defaults to 'auto' (options are: 'auto', 'binary', 'ascii')
* **$permissions** (int) -- File permissions (octal)
返回: TRUE on success, FALSE on failure
返回类型: bool
将一个文件上传到你的服务器上。必须指定本地路径和远程路径这两个参数，而传输模式和权限设置这两个参数则是可选的。例如:
> $this->ftp->upload('/local/path/to/myfile.html', '/public_html/myfile.html', 'ascii', 0775);
如果使用了 auto 模式，将根据源文件的扩展名来自动选择传输模式。
设置权限必须使用一个 八进制 的权限值。
>[info] ### download($rempath, $locpath[, $mode = 'auto'])
参数:
* **$rempath** (string) -- Remote file path
* **$locpath** (string) -- Local file path
* **$mode** (string) -- FTP mode, defaults to 'auto' (options are: 'auto', 'binary', 'ascii')
返回: TRUE on success, FALSE on failure
返回类型: bool
从你的服务器下载一个文件。必须指定远程路径和本地路径，传输模式是可选的。例如：
> $this->ftp->download('/public_html/myfile.html', '/local/path/to/myfile.html', 'ascii');
如果使用了 auto 模式，将根据源文件的扩展名来自动选择传输模式。
如果下载失败（包括 PHP 没有写入本地文件的权限）函数将返回 FALSE 。
>[info] ### rename($old_file, $new_file[, $move = FALSE])
参数:
* **$old_file** (string) -- Old file name
* **$new_file** (string) -- New file name
* **$move** (bool) -- Whether a move is being performed
返回: TRUE on success, FALSE on failure
返回类型: bool
允许你重命名一个文件。需要指定原文件的文件路径和名称，以及新的文件路径和名称。
~~~
// Renames green.html to blue.html
$this->ftp->rename('/public_html/foo/green.html', '/public_html/foo/blue.html');
~~~
>[info] ### move($old_file, $new_file)
参数:
* **$old_file** (string) -- Old file name
* **$new_file** (string) -- New file name
返回: TRUE on success, FALSE on failure
返回类型: bool
允许你移动一个文件。需要指定原路径和目的路径:
~~~
// Moves blog.html from "joe" to "fred"
$this->ftp->move('/public_html/joe/blog.html', '/public_html/fred/blog.html');
~~~
> 注解
> 如果目的文件名和原文件名不同，文件将会被重命名。
>[info] ### delete_file($filepath)
参数:
* **$filepath** (string) -- Path to file to delete
返回: TRUE on success, FALSE on failure
返回类型: bool
用于删除一个文件。需要提供原文件的路径。
~~~
$this->ftp->delete_file('/public_html/joe/blog.html');
~~~
>[info] ### delete_dir($filepath)
参数:
* **$filepath** (string) -- Path to directory to delete
返回: TRUE on success, FALSE on failure
返回类型: bool
用于删除一个目录以及该目录下的所有文件。需要提供目录的路径（以斜线结尾）。
>[danger] 重要
> 使用该方法要非常小心！ 它会递归的删除目录下的所有内容，包括子目录和所有文件。请确保你提供的路径是正确的。 你可以先使用list_files() 方法来验证下路径是否正确。
~~~
$this->ftp->delete_dir('/public_html/path/to/folder/');
~~~
>[info] ### list_files([$path = '.'])
参数:
* **$path** (string) -- Directory path
返回: An array list of files or FALSE on failure
返回类型: array
用于获取服务器上某个目录的文件列表，你需要指定目录路径。
~~~
$list = $this->ftp->list_files('/public_html/');
print_r($list);
~~~
>[info] ### mirror($locpath, $rempath)
参数:
* **$locpath** (string) -- Local path
* **$rempath** (string) -- Remote path
返回: TRUE on success, FALSE on failure
返回类型: bool
递归的读取文本的一个目录和它下面的所有内容（包括子目录），然后通过 FTP 在远程服务器上创建一个镜像。 无论原文件的路径和目录结构是什么样的，都会在远程服务器上一模一样的重建。你需要指定一个原路径和目的路径:
~~~
$this->ftp->mirror('/path/to/myfolder/', '/public_html/myfolder/');
~~~
>[info] ### mkdir($path[, $permissions = NULL])
参数:
* **$path** (string) -- Path to directory to create
* **$permissions** (int) -- Permissions (octal)
返回: TRUE on success, FALSE on failure
返回类型: bool
用于在服务器上创建一个目录。需要指定目录的路径并以斜线结尾。
还可以通过第二个参数传递一个 八进制的值 设置权限。
~~~
// Creates a folder named "bar"
$this->ftp->mkdir('/public_html/foo/bar/', 0755);
~~~
>[info] ### chmod($path, $perm)
参数:
* **$path** (string) -- Path to alter permissions for
* **$perm** (int) -- Permissions (octal)
返回: TRUE on success, FALSE on failure
返回类型: bool
用于设置文件权限。需要指定你想修改权限的文件或目录的路径:
~~~
// Chmod "bar" to 755
$this->ftp->chmod('/public_html/foo/bar/', 0755);
~~~
>[info] ### changedir($path[, $suppress_debug = FALSE])
参数:
* **$path** (string) -- Directory path
* **$suppress_debug** (bool) -- Whether to turn off debug messages for this command
返回: TRUE on success, FALSE on failure
返回类型: bool
用于修改当前工作目录到指定路径。
如果你希望使用这个方法作为 is_dir() 的一个替代，$suppress_debug 参数将很有用。
>[info] ### close()
返回: TRUE on success, FALSE on failure
返回类型: bool
断开和服务器的连接。当你上传完毕时，建议使用这个函数。
- 欢迎使用 CodeIgniter
- 安装说明
- 下载 CodeIgniter
- 安装说明
- 从老版本升级
- 疑难解答
- CodeIgniter 概览
- CodeIgniter 将从这里开始
- CodeIgniter 是什么？
- 支持特性
- 应用程序流程图
- 模型-视图-控制器
- 设计与架构目标
- 教程 - 内容提要
- 加载静态内容
- 读取新闻条目
- 创建新闻条目
- 结束语
- 常规主题
- CodeIgniter URL
- 控制器
- 保留名称
- 视图
- 模型
- 辅助函数
- 使用 CodeIgniter 类库
- 创建类库
- 使用 CodeIgniter 驱动器
- 创建驱动器
- 创建核心系统类
- 创建附属类
- 钩子 - 扩展框架核心
- 自动加载资源
- 公共函数
- 兼容性函数
- URI 路由
- 错误处理
- 网页缓存
- 程序分析
- 以 CLI 方式运行
- 管理你的应用程序
- 处理多环境
- 在视图文件中使用 PHP 替代语法
- 安全
- PHP 开发规范
- 类库参考
- 基准测试类
- 缓存驱动器
- 日历类
- 购物车类
- 配置类
- Email 类
- 加密类
- 加密类（新版）
- 文件上传类
- 表单验证类
- FTP 类
- 图像处理类
- 输入类
- Javascript 类
- 语言类
- 加载器类
- 迁移类
- 输出类
- 分页类
- 模板解析类
- 安全类
- Session 类
- HTML 表格类
- 引用通告类
- 排版类
- 单元测试类
- URI 类
- 用户代理类
- XML-RPC 与 XML-RPC 服务器类
- Zip 编码类
- 数据库参考
- 数据库快速入门: 示例代码
- 数据库配置
- 连接你的数据库
- 查询
- 生成查询结果
- 查询辅助函数
- 查询构造器类
- 事务
- 数据库元数据
- 自定义函数调用
- 数据库缓存类
- 数据库工厂类
- 数据库工具类
- 数据库驱动器参考
- 辅助函数参考
- 数组辅助函数
- 验证码辅助函数
- Cookie 辅助函数
- 日期辅助函数
- 目录辅助函数
- 下载辅助函数
- 邮件辅助函数
- 文件辅助函数
- 表单辅助函数
- HTML 辅助函数
- 语言辅助函数
- Inflector 辅助函数
- 数字辅助函数
- 路径辅助函数
- 安全辅助函数
- 表情辅助函数
- 字符串辅助函数
- 文本辅助函数
- 排版辅助函数
- URL 辅助函数
- XML 辅助函数
- 向 CodeIgniter 贡献你的力量