如何使用 PHP FTP 正确上传用户提交的图片文件-php教程-PHP中文网

如何使用 PHP FTP 正确上传用户提交的图片文件

本文详解 PHP 中通过 FTP 上传表单图片时常见的路径错误，重点指出 $_FILES 数组中 'name'（原始文件名）与 'tmp_name'（临时存储路径）的区别，并提供可直接运行的修复代码及最佳实践。

本文详解 php 中通过 ftp 上传表单图片时常见的路径错误，重点指出 `$_files` 数组中 `'name'`（原始文件名）与 `'tmp_name'`（临时存储路径）的区别，并提供可直接运行的修复代码及最佳实践。

在 Web 开发中，使用 PHP 的 FTP 扩展上传用户提交的图片（如 PNG、JPG）是常见需求。但许多开发者会遇到类似 ftp_put(image.png): Failed to open stream: No such file or directory 的警告，导致上传失败。根本原因在于混淆了 $_FILES 超全局数组中两个关键键值的用途：

$_FILES['srcfile']['name']：用户上传时的原始文件名（例如 "logo.png"），仅用于构建远程目标路径；
$_FILES['srcfile']['tmp_name']：PHP 在服务器上生成的临时文件绝对路径（例如 "/tmp/phpABC123"），这才是 ftp_put() 必须读取的真实源文件位置。

原始代码中直接使用 $_FILES['srcfile']['name'] 作为本地文件路径，等同于尝试读取当前工作目录下的 image.png —— 该文件并不存在，因此触发 Failed to open stream 错误。

✅ 正确做法如下（含完整流程校验）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

// 1. 确保 FTP 连接已建立且登录成功（此处省略连接逻辑）
// $ftpcon = ftp_connect($host);
// ftp_login($ftpcon, $user, $pass);

// 2. 验证目标目录存在并切换进去（提升健壮性）
if (!ftp_chdir($ftpcon, 'test')) {
    die('Error: Cannot change to remote directory "test"');
}

// 3. 获取文件元信息
$remote_dir = 'test/';
$src_name = $_FILES['srcfile']['name'];
$temp_file_path = $_FILES['srcfile']['tmp_name'];

// ⚠️ 关键校验：确保文件已成功上传至临时目录
if (empty($temp_file_path) || !is_uploaded_file($temp_file_path)) {
    die('Error: Invalid or missing uploaded file.');
}

$remote_file_path = $remote_dir . basename($src_name); // 使用 basename() 防止路径遍历

// 4. 执行二进制模式上传（适用于图片、PDF 等非文本文件）
if (ftp_put($ftpcon, $remote_file_path, $temp_file_path, FTP_BINARY)) {
    echo '✅ File "' . htmlspecialchars($src_name) . '" uploaded successfully to /test/';
} else {
    echo '❌ Error uploading file: ' . ftp_strerror($ftpcon);
}

// 5. 可选：关闭连接
ftp_close($ftpcon);

? 重要注意事项：