README

一个简单的 Laravel 5 ftp 服务提供者。

对于 Laravel 4.x，请查看v1.0.0

安装

将包添加到您的 composer.json 文件中，并运行 composer update。

{
    "require": {
        "polyerter/ftp": "dev-master"
    }
}

在 config/app.php 中添加服务提供者

'Anchu\Ftp\FtpServiceProvider',

配置

运行 php artisan vendor:publish 并修改配置文件（config/ftp.php）以添加您的 ftp 连接。

您可以使用以下语法添加动态 ftp 连接

Config::set('ftp.connections.key', array(
           'host'   => '',
           'username' => '',
           'password'   => '',
           'passive'   => false,
));

访问连接

您可以通过 FTP::connection 方法访问默认 ftp 连接

FTP::connection()->getDirListing(...);

当使用多个连接时，您可以通过传递连接名称来访问每个特定的 ftp 连接

FTP::connection('foo')->getDirListing(...);

有时您可能需要重新连接到特定的 ftp

FTP::reconnect('foo');

如果您需要从特定的 ftp 断开连接，请使用断开连接方法

FTP::disconnect('foo');

基本用法示例

// With custom connection
$listing = FTP::connection('my-ftp-connection')->getDirListing();

// with default connection
$listing = FTP::connection()->getDirListing();
$status = FTP::connection()->makeDir('directory-name');

支持的方法

getDirListing($directory, $parameters )

返回指定目录中的文件列表

• $directory: 要列出的目录。默认值：.。
• $parameters: 可选参数，用于添加到目录前。例如：-la。默认：null。

getDirListingDetailed($directory)

返回指定目录中的文件列表，作为一个包含以下键的关联数组：权限、数字、用户、组、大小、月份、日期和时间

• $directory: 要列出的目录。默认值：.。

makeDir($directory)

在 FTP 服务器上创建指定的目录。

• $directory: 要创建的目录的名称。

changeDir($directory)

更改 FTP 服务器上的当前目录。

• $directory: 目标目录。

uploadFile($fileFrom, $fileTo, $mode)

将本地文件上传到 FTP 服务器。

• $fileFrom: 本地文件路径。
• $fileTo: 远程文件路径。
• $mode: 传输模式。必须是 FTP_ASCII 或 FTP_BINARY。如果没有指定模式，将自动完成模式解析。

downloadFile($fileFrom, $fileTo, $mode)

从 FTP 服务器下载文件

• $fileFrom: 远程文件路径。
• $fileTo: 本地文件路径（如果文件已存在，将被覆盖）或用于存储数据的打开文件指针。
• .
• $mode: 传输模式。必须是 FTP_ASCII 或 FTP_BINARY。如果没有指定模式，将自动完成模式解析。

readFile($fileFrom)

与 downloadFile() 方法相同，除了它将远程文件下载到 PHP 输出缓冲区并返回它。

• $fileFrom: 远程文件路径。

moveUp()

切换到父目录。

permission($mode, $filename)

设置文件的权限。

• $mode: 新权限，以八进制值表示。
• $filename: 远程文件。

delete($path)

从 FTP 服务器中删除由路径指定的文件。

• $path: 要删除的文件。

currentDir()

返回当前目录名称

rename($oldName, $newName)

在 FTP 服务器上重命名文件或目录。

• $oldName: 旧文件/目录名称。
• $newName: 新名称。

removeDir($directory, $recursive)

删除目录。

• $directory: 要删除的目录。这必须是绝对路径或相对路径到一个空目录。
• $recursive: 递归删除文件夹。默认值：false。

truncateDir($directory)

截断目录。

• $directory: 要截断的目录。这必须是绝对路径或相对路径到一个目录。

size($remoteFile)

以字节为单位返回给定文件的大小。 注意：并非所有服务器都支持此功能。

• $remoteFile：远程文件。

time($remoteFile)

返回指定文件的最后修改时间 注意：并非所有服务器都支持此功能。

• $remoteFile：远程文件。