©
Dokumen ini menggunakanManual laman web PHP CinaLepaskan
CodeIgniter的FTP类允许文件传输到远程服务器。远程文件也可以被移动，重命名和删除。FTP类还包含一个“镜像”功能，允许通过FTP远程重建整个本地目录。
注意
不支持SFTP和SSL FTP协议，只有标准FTP。
使用FTP类
初始化类
用法示例
类参考
像CodeIgniter中的大多数其他类一样，FTP类在您的控制器中使用$ this-> load-> library函数进行初始化：
$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();
在这个例子中，从服务器中检索一个文件列表。
$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();
在这个例子中，本地目录在服务器上被镜像。
$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();
class CI_FTPconnect([$config = array()])
|
参数： |
$ config（array） - 连接值 |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ config（array） - 连接值
Returns: TRUE on success, FALSE on failure
Return type: 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文件中，它将自动使用。
可用的连接选项
选项名称默认值说明**主机名**不适用FTP主机名（通常类似于：ftp.example.com）**用户名**不适用FTP用户名**密码**不适用FTP密码**端口* * 21 FTP服务器端口号** debug ** FALSE TRUE / FALSE（boolean）：是否启用调试以显示错误消息** passive ** TRUE TRUE / FALSE（布尔值）：是否使用被动模式
upload($locpath, $rempath[, $mode = 'auto'[, $permissions = NULL]])
|
参数： |
$ locpath（string） - 本地文件路径$ rempath（string） - 远程文件路径$ mode（string） - FTP模式，默认为'auto'（选项为'auto'，'binary'，'ascii'）$ permissions （int） - 文件权限（八进制） |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ locpath（字符串） - 本地文件路径
$ rempath（字符串） - 远程文件路径
$ mode（字符串） - FTP模式，默认为'auto'（选项为：'auto'，'binary'，'ascii'）
$ permissions（int） - 文件权限（八进制）
返回：成功时为TRUE，失败时为FALSE
Return type: bool
将文件上传到您的服务器。您必须提供本地路径和远程路径，并且可以选择设置模式和权限。例：
$this->ftp->upload('/local/path/to/myfile.html', '/public_html/myfile.html', 'ascii', 0775);
如果使用“自动”模式，它将以源文件的文件扩展名为基础。
如果设置，权限必须作为八进制值传递。
download($rempath, $locpath[, $mode = 'auto'])
|
参数： |
$ rempath（string） - 远程文件路径$ locpath（string） - 本地文件路径$ mode（string） - FTP模式，默认为'auto'（选项为'auto'，'binary'，'ascii'） |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ rempath（字符串） - 远程文件路径
$ locpath（字符串） - 本地文件路径
$ mode（字符串） - FTP模式，默认为'auto'（选项为：'auto'，'binary'，'ascii'）
返回：成功时为TRUE，失败时为FALSE
Return type: bool
从服务器下载文件。您必须提供远程路径和本地路径，您可以选择设置模式。例：
$this->ftp->download('/public_html/myfile.html', '/local/path/to/myfile.html', 'ascii');
如果使用“自动”模式，它将以源文件的文件扩展名为基础。
如果下载未成功执行（包括PHP没有写入本地文件的权限），则返回FALSE。
rename($old_file, $new_file[, $move = FALSE])
|
参数： |
$ old_file（字符串） - 旧文件名$ new_file（字符串） - 新文件名$ move（bool） - 是否正在执行移动 |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ old_file（字符串） - 旧文件名
$ new_file（字符串） - 新文件名
$ move（bool） - 是否正在执行移动
Returns: TRUE on success, FALSE on failure
Return type: bool
允许您重命名文件。提供源文件名/路径和新文件名/路径。
//将green.html重命名为blue.html $ this-> ftp-> rename（'/ public_html / foo / green.html'，'/public_html/foo/blue.html'）;
move($old_file, $new_file)
|
参数： |
$ old_file（字符串） - 旧文件名$ new_file（字符串） - 新文件名 |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ old_file（字符串） - 旧文件名
$ new_file（字符串） - 新文件名
Returns: TRUE on success, FALSE on failure
Return type: bool
让你移动一个文件。提供源和目标路径：
// Moves blog.html from "joe" to "fred" $this->ftp->move('/public_html/joe/blog.html', '/public_html/fred/blog.html');
注意
如果目标文件名不同，则文件将被重命名。
delete_file($filepath)
|
参数： |
$ filepath（字符串） - 要删除的文件的路径 |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ filepath（字符串） - 要删除的文件的路径
Returns: TRUE on success, FALSE on failure
Return type: bool
让你删除一个文件。使用文件名提供源路径。
$this->ftp->delete_file('/public_html/joe/blog.html');
delete_dir($filepath)
|
参数： |
$ filepath（字符串） - 要删除的目录的路径 |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ filepath（字符串） - 要删除的目录的路径
Returns: TRUE on success, FALSE on failure
Return type: bool
允许您删除目录及其包含的所有内容。用尾部斜杠提供目录的源路径。
重要
用这种方法非常小心！它将递归地删除提供的路径中的所有内容，包括子文件夹和所有文件。确保你的路径是正确的。先尝试使用list_files()以验证您的路径是否正确。
$this->ftp->delete_dir('/public_html/path/to/folder/');
list_files([$path = '.'])
|
参数： |
$ path（string） - 目录路径 |
|---|---|
|
返回： |
文件的数组列表或失败时的FALSE |
|
返回类型： |
排列 |
$ path（string） - 目录路径
返回：文件的数组列表或失败时的FALSE
Return type: array
允许您检索服务器上以文件形式返回的文件列表。您必须提供所需目录的路径。
$list = $this->ftp->list_files('/public_html/'); print_r($list);
mirror($locpath, $rempath)
|
参数： |
$ locpath（字符串） - 本地路径$ rempath（字符串） - 远程路径 |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ locpath（字符串） - 本地路径
$ rempath（string） - 远程路径
Returns: TRUE on success, FALSE on failure
Return type: bool
递归读取本地文件夹及其包含的所有内容（包括子文件夹），并基于此文件通过FTP创建镜像。无论在服务器上重新创建原始文件路径的目录结构。您必须提供源路径和目标路径：
$this->ftp->mirror('/path/to/myfolder/', '/public_html/myfolder/');
mkdir($path[, $permissions = NULL])
|
参数： |
$ path（string） - 创建$ permissions的目录路径（int） - 权限（八进制） |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ path（string） - 要创建的目录的路径
$ permissions（int） - 权限（八进制）
Returns: TRUE on success, FALSE on failure
Return type: bool
让您在服务器上创建一个目录。提供以您希望创建的文件夹名称结尾的路径，并以斜杠结尾。
权限可以通过在第二个参数中传递八进制值来设置。
// Creates a folder named "bar" $this->ftp->mkdir('/public_html/foo/bar/', 0755);
chmod($path, $perm)
|
参数： |
$ path（string） - 修改$ perm（int）权限的路径 - 权限（八进制） |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ path（string） - 修改权限的路径
$ perm（int） - 权限（八进制）
Returns: TRUE on success, FALSE on failure
Return type: bool
Permits you to set file permissions. Supply the path to the file or directory you wish to alter permissions on:
// Chmod "bar" to 755 $this->ftp->chmod('/public_html/foo/bar/', 0755);
changedir($path[, $suppress_debug = FALSE])
|
参数： |
$ path（string） - 目录路径$ suppress_debug（bool） - 是否关闭此命令的调试消息 |
|---|---|
|
返回： |
成功为TRUE，失败为FALSE |
|
返回类型： |
布尔 |
$ path（string） - 目录路径
$ suppress_debug（bool） - 是否关闭此命令的调试消息
Returns: TRUE on success, FALSE on failure
Return type: bool
将当前工作目录更改为指定的路径。
$suppress_debug如果您想将此方法用作is_dir()FTP 的替代方法，该参数非常有用。
close()
|
返回： |
成功为TRUE，失败为FALSE |
|---|---|
|
返回类型： |
布尔 |