本文详解 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 错误。
✅ 正确做法如下（含完整流程校验）：
// 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);? 重要注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 始终使用
is_uploaded_file()校验$temp_file_path，防止恶意构造的文件路径攻击； - 推荐对
$src_name调用basename()，避免用户提交如../../etc/passwd类路径造成目录穿越； - 图片等二进制文件必须使用
FTP_BINARY模式（而非FTP_ASCII），否则可能损坏文件头； - 生产环境建议配合
error_get_last()或日志记录，便于排查网络超时、权限不足等深层问题； - 若需更高安全性与并发支持，推荐迁移到 SFTP（
phpseclib）或对象存储（如 AWS S3/MinIO）方案。
掌握 $_FILES 数组各字段语义，是安全、可靠处理文件上传的第一道防线。
