README

简单的 Laravel 8 ftp 服务提供者。

对于 Laravel 8.x，请查看 [v1.0.0]

安装

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

{
    "require": {
        "JackyLiu/ftp": "~1.0"
    }
}

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

'JackyLiu\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：远程文件。