PHP 通过 FTP 创建并上传新文件教程-php教程-PHP中文网

PHP 通过 FTP 创建并上传新文件教程

DDD

发布： 2025-08-23 18:46:33

原创

834人浏览过

php 通过 ftp 创建并上传新文件教程

本教程详细介绍了如何使用 PHP 通过 FTP 协议在远程服务器上创建并上传新文件。文章涵盖了 FTP 连接的建立、登录验证、文件上传以及连接关闭等关键步骤，并提供了示例代码，帮助开发者快速掌握 PHP FTP 文件上传的实现方法，同时避免常见的上传失败问题。

使用 PHP 进行 FTP 文件上传

PHP 提供了强大的 FTP 函数库，可以方便地与 FTP 服务器进行交互，实现文件的上传和下载。以下是一个详细的步骤指南，帮助你创建并上传新文件。

1. 建立 FTP 连接

首先，需要使用 ftp_connect() 函数建立与 FTP 服务器的连接。你需要提供 FTP 服务器的地址作为参数。

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

$ftp_server = "your_ftp_server_address";
$conn_id = ftp_connect($ftp_server);

登录后复制

2. 登录 FTP 服务器

连接建立后，需要使用 ftp_login() 函数进行身份验证。你需要提供用户名和密码作为参数。

$ftp_user_name = "your_ftp_username";
$ftp_user_pass = "your_ftp_password";
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

登录后复制

3. 检查连接和登录状态

在进行后续操作之前，务必检查连接和登录是否成功。

if ((!$conn_id) || (!$login_result)) {
    die("FTP connection failed! Attempted to connect to $ftp_server for user $ftp_user_name");
} else {
    echo "Connected to $ftp_server, for user $ftp_user_name\n";
}

登录后复制

4. 设置被动模式 (PASV)

为了提高兼容性，建议启用被动模式。

ftp_pasv($conn_id, true);

登录后复制

5. 创建本地文件 (如果需要)

码上飞

码上飞（CodeFlying）是一款AI自动化开发平台，通过自然语言描述即可自动生成完整应用程序。

138

查看详情

如果需要上传的文件不存在，则需要先创建它。以下代码演示了如何创建一个简单的文本文件：

$local_file = "newfile.txt";
$handle = fopen($local_file, "w");
fwrite($handle, "This is some sample text.\n");
fwrite($handle, "More text here.\n");
fclose($handle);

登录后复制

6. 上传文件

使用 ftp_put() 函数上传文件到 FTP 服务器。你需要提供连接 ID、目标文件名、本地文件名和传输模式作为参数。常用的传输模式有 FTP_ASCII (文本模式) 和 FTP_BINARY (二进制模式)。根据上传的文件类型选择合适的模式。

$remote_file = "newfile.txt"; // FTP服务器上的目标文件名
$local_file = "newfile.txt";   // 本地文件名
$upload = ftp_put($conn_id, $remote_file, $local_file, FTP_ASCII);

登录后复制

7. 检查上传结果

检查上传是否成功。

if (!$upload) {
    echo "FTP upload has failed!\n";
} else {
    echo "Uploaded $local_file to $ftp_server as $remote_file\n";
}

登录后复制

8. 关闭 FTP 连接

上传完成后，使用 ftp_close() 函数关闭 FTP 连接。

ftp_close($conn_id);

登录后复制

完整示例代码

<?php

$ftp_server = "your_ftp_server_address";
$ftp_user_name = "your_ftp_username";
$ftp_user_pass = "your_ftp_password";
$remote_file = "newfile.txt"; // FTP服务器上的目标文件名
$local_file = "newfile.txt";   // 本地文件名

// 创建本地文件
$handle = fopen($local_file, "w");
fwrite($handle, "This is some sample text.\n");
fwrite($handle, "More text here.\n");
fclose($handle);


// set up basic connection
$conn_id = ftp_connect($ftp_server);

// login with username and password
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

// check connection
if ((!$conn_id) || (!$login_result)) {
    die("FTP connection failed! Attempted to connect to $ftp_server for user $ftp_user_name");
} else {
    echo "Connected to $ftp_server, for user $ftp_user_name\n";
}

// turn passive mode on
ftp_pasv($conn_id, true);

// 上传文件
$upload = ftp_put($conn_id, $remote_file, $local_file, FTP_ASCII);

// check upload status
if (!$upload) {
    echo "FTP upload has failed!\n";
} else {
    echo "Uploaded $local_file to $ftp_server as $remote_file\n";
}

// close the FTP stream
ftp_close($conn_id);

?>

登录后复制

注意事项

权限问题: 确保 FTP 用户具有在目标目录下创建和写入文件的权限。
防火墙: 某些防火墙可能会阻止 FTP 连接。确保防火墙允许 FTP 流量。
传输模式: 选择正确的传输模式非常重要。对于文本文件，使用 FTP_ASCII。对于二进制文件（例如图像、压缩文件），使用 FTP_BINARY。
错误处理: 在实际应用中，应该添加更完善的错误处理机制，例如使用 try-catch 块来捕获异常。
安全性: 避免在代码中硬编码用户名和密码。可以考虑使用配置文件或环境变量来存储敏感信息。
文件名冲突: 如果目标文件已存在，ftp_put() 默认会覆盖它。如果需要避免覆盖，可以先使用 ftp_size() 检查文件是否存在，并根据需要更改目标文件名。