PHP怎么通过FTP下载文件？详细实现步骤是什么

PHP通过FTP下载文件的核心流程

PHP通过FTP下载文件主要依赖内置的FTP扩展函数，核心步骤分为建立FTP连接、登录验证、执行文件下载、关闭连接四个部分。首先需要确保PHP环境已经开启了FTP扩展，一般默认情况下该扩展是开启的，可以通过phpinfo()函数查看是否存在FTP相关模块。

1. 建立FTP连接并登录

使用ftp_connect函数建立与FTP服务器的连接，再使用ftp_login函数完成身份验证，这是后续所有操作的基础。

<?php
// FTP服务器地址
$ftp_server = "192.168.0.1";
// FTP端口 默认21
$ftp_port = 21;
// FTP用户名
$ftp_user = "test_user";
// FTP密码
$ftp_pass = "test_password";

// 建立FTP连接
$conn_id = ftp_connect($ftp_server, $ftp_port);
if (!$conn_id) {
    die("无法连接到FTP服务器");
}

// 登录FTP服务器
$login_result = ftp_login($conn_id, $ftp_user, $ftp_pass);
if (!$login_result) {
    die("FTP登录失败，请检查用户名和密码");
}

// 开启被动模式 部分服务器需要开启才能正常传输
ftp_pasv($conn_id, true);
?>

2. 执行文件下载操作

登录成功后，使用ftp_get函数将远程FTP服务器上的文件下载到本地服务器指定路径，该函数支持多种传输模式，默认使用二进制模式，适合所有类型的文件。

<?php
// 远程FTP服务器上的文件路径
$remote_file = "/data/files/test.zip";
// 本地保存文件的路径
$local_file = "/home/wwwroot/local_files/test.zip";

// 执行文件下载操作
// FTP_BINARY 表示二进制传输模式 FTP_ASCII 表示文本模式
$download_result = ftp_get($conn_id, $local_file, $remote_file, FTP_BINARY);

if ($download_result) {
    echo "文件下载成功，保存路径：" . $local_file;
} else {
    echo "文件下载失败，请检查远程文件路径和本地目录权限";
}
?>

3. 关闭FTP连接

文件下载操作完成后，需要及时关闭FTP连接释放资源，使用ftp_close函数即可完成。

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

常见问题与注意事项

• 如果下载大文件时出现超时，可以调整PHP的max_execution_time配置，或者在代码中通过set_time_limit(0)设置不限制执行时间。
• 本地保存目录需要有写入权限，否则会导致下载失败，可以通过is_writable函数提前检查目录权限。
• 如果FTP服务器使用的是非标准端口，需要在ftp_connect函数的第二个参数中指定正确的端口号。
• 部分FTP服务器需要开启被动模式才能正常传输文件，可以通过ftp_pasv函数设置为true开启。

完整示例代码

以下是整合了所有步骤的完整示例代码，可以直接根据实际需求修改参数后使用。

<?php
// FTP配置信息
$ftp_server = "192.168.0.1";
$ftp_port = 21;
$ftp_user = "test_user";
$ftp_pass = "test_password";
$remote_file = "/data/files/test.zip";
$local_file = "/home/wwwroot/local_files/test.zip";

// 建立连接
$conn_id = ftp_connect($ftp_server, $ftp_port);
if (!$conn_id) {
    die("FTP连接失败");
}

// 登录
if (!ftp_login($conn_id, $ftp_user, $ftp_pass)) {
    die("FTP登录失败");
}

// 开启被动模式
ftp_pasv($conn_id, true);

// 检查本地目录是否可写
$local_dir = dirname($local_file);
if (!is_writable($local_dir)) {
    die("本地目录没有写入权限：" . $local_dir);
}

// 执行下载
if (ftp_get($conn_id, $local_file, $remote_file, FTP_BINARY)) {
    echo "文件下载成功，路径：" . $local_file;
} else {
    echo "文件下载失败";
}

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

PHPFTP文件下载ftp_get修改时间：2026-06-05 15:41:57