CodeIgniter的FTP类允许文件传输到远程服务器。远程文件也可以被移动，重命名和删除。FTP类还包含一个“镜像”功能，允许通过FTP远程重建整个本地目录。

注意

不支持SFTP和SSL FTP协议，只有标准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） - 连接值

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（字符串） - 本地文件路径

• $ 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（字符串） - 远程文件路径

• $ 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） - 是否正在执行移动

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（字符串） - 新文件名

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（字符串） - 要删除的文件的路径

Returns:  TRUE on success, FALSE on failure

Return type:  bool

让你删除一个文件。使用文件名提供源路径。

$this->ftp->delete_file('/public_html/joe/blog.html');

delete_dir($filepath)

• $ 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

Return type:  array

允许您检索服务器上以文件形式返回的文件列表。您必须提供所需目录的路径。

$list = $this->ftp->list_files('/public_html/'); print_r($list);

mirror($locpath, $rempath)

• $ 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） - 权限（八进制）

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） - 权限（八进制）

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） - 是否关闭此命令的调试消息

Returns:  TRUE on success, FALSE on failure

Return type:  bool

将当前工作目录更改为指定的路径。

$suppress_debug如果您想将此方法用作is_dir()FTP 的替代方法，该参数非常有用。

close()