ftp_fget

适用PHP版本

PHP 4, PHP 5, PHP 7, PHP 8

函数说明

ftp_fget() 函数从 FTP 服务器上下载文件，并将文件内容写入一个打开的本地文件流。

函数语法

bool ftp_fget(resource $ftp_stream, resource $handle, string $remote_file, int $mode, int $offset = 0)

参数

• $ftp_stream：由 ftp_connect() 或 ftp_ssl_connect() 返回的 FTP 连接资源。
• $handle：一个有效的文件句柄，必须是已打开的文件流（使用 fopen() 打开），用于写入下载的文件内容。
• $remote_file：远程文件路径，指定要下载的 FTP 服务器上的文件。
• $mode：传输模式。可以是 FTP_ASCII 或 FTP_BINARY，通常二进制传输使用 FTP_BINARY。
• $offset（可选）：从远程文件的指定字节偏移处开始下载，默认从文件头开始下载。

返回值

成功时返回 true，失败时返回 false。

示例

以下示例展示了如何通过 ftp_fget() 函数将 FTP 服务器上的文件下载到本地文件中：

示例代码：

<?php
$ftp_server = "ftp.example.com";
$ftp_user = "username";
$ftp_pass = "password";
$remote_file = "/path/on/server/file.txt";
$local_file = "local_file.txt";

// 连接 FTP 服务器
$conn_id = ftp_connect($ftp_server);

// 登录 FTP
if (@ftp_login($conn_id, $ftp_user, $ftp_pass)) {
// 打开本地文件用于写入
$handle = fopen($local_file, "w");
if ($handle) {
// 下载远程文件写入本地文件
if (ftp_fget($conn_id, $handle, $remote_file, FTP_BINARY)) {
echo "文件下载成功！";
} else {
echo "文件下载失败。";
}
fclose($handle);
} else {
echo "无法打开本地文件。";
}
} else {
echo "FTP 登录失败。";
}

// 关闭 FTP 连接
ftp_close($conn_id);
?>

示例代码的说明

示例代码首先连接并登录到指定的 FTP 服务器。成功登录后，打开本地文件用于写入。接着使用 ftp_fget() 从 FTP 服务器上下载指定的远程文件，并将内容写入本地文件。如果下载成功，会输出“文件下载成功！”，否则提示下载失败。最后关闭打开的文件句柄和 FTP 连接。