使用PHP实现FTP文件下载：完整指南

夜涛同学_9059

发布时间：2025-11-17 13:38:29

934人浏览过

来源于php中文网

原创

使用PHP实现FTP文件下载：完整指南

本教程详细介绍了如何使用php从ftp服务器下载文件。内容涵盖了php ftp扩展的启用、建立ftp连接、用户认证、以及利用`ftp_get`函数执行文件下载的完整流程。通过分步指导和示例代码，帮助开发者在php应用中高效、安全地实现ftp文件传输功能。

在许多Web应用场景中，从远程FTP服务器下载文件是常见的需求。PHP提供了一套内置的FTP函数，使得这一过程变得相对简单。本文将为您提供一个全面的教程，指导您如何使用PHP实现FTP文件下载。

1. 准备工作：启用PHP FTP扩展

在开始编写PHP代码之前，您需要确保PHP的FTP扩展已启用。大多数PHP安装默认不启用此扩展，因此您可能需要手动配置。

编辑 php.ini 文件：找到您的PHP配置文件 php.ini。通常，您可以通过运行 phpinfo() 函数来查找其位置。
查找并启用扩展：在 php.ini 文件中，查找 extension= 开头的行。找到或添加以下行：
```
extension=ftp
```
在某些系统中，可能需要使用 --enable-ftp 编译选项来构建PHP，但对于大多数预编译的PHP版本，取消注释 extension=ftp 即可。
重启Web服务器：保存 php.ini 文件后，您需要重启您的Web服务器（如Apache, Nginx或PHP-FPM），以使更改生效。
验证：创建一个简单的PHP文件，包含，在浏览器中访问它，然后搜索 "FTP"。如果看到FTP相关的配置信息，说明扩展已成功启用。

2. 建立FTP连接与文件下载

一旦FTP扩展启用，您就可以开始编写代码来连接FTP服务器并下载文件了。

立即学习“PHP免费学习笔记（深入）”；

2.1 建立FTP连接

首先，您需要使用 ftp_connect() 函数与FTP服务器建立连接。

password-manager

本地密码管理技能，可添加、编辑、删除、搜索密码，支持分类和备注，数据本地存储，支持导入导出和备份。用户提及密码、账号、密码管理、保存密码或查找密码时使用。

下载

<?php
$ftp_server = "ftp.example.com"; // 替换为您的FTP服务器地址

// 尝试连接FTP服务器，如果失败则终止脚本并报错
$ftp_conn = ftp_connect($ftp_server) or die("无法连接到FTP服务器: $ftp_server");
echo "成功连接到FTP服务器: $ftp_server\n";
?>

2.2 用户认证

连接成功后，您需要使用 ftp_login() 函数进行用户认证。

<?php
// ... (之前的ftp_connect代码) ...

$ftp_user_name = "your_username"; // 替换为您的FTP用户名
$ftp_user_pass = "your_password"; // 替换为您的FTP密码

// 尝试登录FTP服务器
if (ftp_login($ftp_conn, $ftp_user_name, $ftp_user_pass)) {
    echo "FTP登录成功\n";
} else {
    die("FTP登录失败，请检查用户名和密码\n");
}
?>

2.3 执行文件下载

认证成功后，即可使用 ftp_get() 函数从FTP服务器下载文件到本地。

<?php
// ... (之前的ftp_connect和ftp_login代码) ...

$local_file_path = "local_downloaded_file.zip"; // 本地保存文件的路径和名称
$server_file_path = "test/file.zip";            // FTP服务器上的文件路径和名称

// 尝试下载文件
// FTP_BINARY 用于下载二进制文件（如图片、压缩包），推荐用于大多数文件
// FTP_ASCII 用于下载文本文件
if (ftp_get($ftp_conn, $local_file_path, $server_file_path, FTP_BINARY)) {
    echo "文件 '$server_file_path' 已成功下载到 '$local_file_path'\n";
} else {
    echo "文件下载失败，请检查文件路径和权限\n";
}
?>

2.4 关闭FTP连接

文件传输完成后，务必使用 ftp_close() 函数关闭FTP连接，释放资源。

<?php
// ... (之前的ftp_get代码) ...

// 关闭FTP连接
ftp_close($ftp_conn);
echo "FTP连接已关闭\n";
?>

3. 完整示例代码

将以上步骤整合，形成一个完整的PHP脚本：

<?php

// ------------------- 配置信息 -------------------
$ftp_server = "ftp.example.com";         // FTP服务器地址
$ftp_user_name = "your_username";        // FTP用户名
$ftp_user_pass = "your_password";        // FTP密码
$local_file_path = "local_downloaded_file.zip"; // 本地保存文件的路径和名称
$server_file_path = "test/file.zip";    // FTP服务器上的文件路径和名称
// ------------------------------------------------

// 1. 建立FTP连接
$ftp_conn = ftp_connect($ftp_server);
if (!$ftp_conn) {
    die("错误: 无法连接到FTP服务器 '$ftp_server'\n");
}
echo "成功连接到FTP服务器: $ftp_server\n";

// 2. 登录FTP服务器
$login_result = ftp_login($ftp_conn, $ftp_user_name, $ftp_user_pass);
if (!$login_result) {
    ftp_close($ftp_conn); // 登录失败也要关闭连接
    die("错误: FTP登录失败，请检查用户名和密码。\n");
}
echo "FTP登录成功\n";

// (可选) 开启被动模式，解决某些防火墙问题
// ftp_pasv($ftp_conn, true);

// 3. 尝试下载文件
// 确保本地目标目录有写入权限
if (ftp_get($ftp_conn, $local_file_path, $server_file_path, FTP_BINARY)) {
    echo "文件 '$server_file_path' 已成功下载到 '$local_file_path'\n";
} else {
    echo "错误: 文件 '$server_file_path' 下载失败，请检查服务器文件路径和本地写入权限。\n";
}

// 4. 关闭FTP连接
ftp_close($ftp_conn);
echo "FTP连接已关闭。\n";

?>

4. 注意事项与最佳实践

安全性：
- 不要在代码中硬编码敏感信息：FTP用户名和密码应存储在PHP无法直接访问的配置文件、环境变量或安全的密钥管理系统中。
- 使用SFTP/FTPS：如果可能，优先使用更安全的SFTP（SSH File Transfer Protocol）或FTPS（FTP Secure），而不是纯粹的FTP。PHP提供了ssh2_sftp等扩展支持SFTP。
错误处理：
- 在生产环境中，应增加更健壮的错误处理机制，例如记录错误日志而不是直接 die()，并向用户显示友好的错误消息。
- ftp_raw() 可以获取FTP服务器的原始响应，有助于调试。
传输模式：
- FTP_BINARY：用于传输非文本文件，如图片、视频、压缩包等。这是最常用的模式。
- FTP_ASCII：用于传输纯文本文件。在不同操作系统间传输文本文件时，它会自动处理行结束符转换。
- 选择错误的模式可能导致文件损坏。
被动模式（PASV）：
- 在某些网络环境下，特别是当服务器或客户端位于防火墙后时，可能需要使用 ftp_pasv($ftp_conn, true); 开启被动模式，以解决连接问题。
超时设置：
- ftp_set_option($ftp_conn, FTP_TIMEOUT_SEC, 90); 可以设置FTP操作的超时时间，防止长时间无响应。
文件权限：
- 确保PHP脚本运行的用户对本地目标下载目录具有写入权限，否则 ftp_get() 会因权限不足而失败。