本文详解 PHP 文件上传中 move_uploaded_file() 使用错误导致图片无法上传的问题，重点纠正路径参数误用、源文件路径混淆等典型错误，并提供安全可靠的完整上传代码示例。
本文详解 php 文件上传中 `move_uploaded_file()` 使用错误导致图片无法上传的问题，重点纠正路径参数误用、源文件路径混淆等典型错误，并提供安全可靠的完整上传代码示例。
在使用 PHP 和 MySQL 构建网站时，图片上传功能是常见需求，但开发者常因对 $_FILES 数组结构和 move_uploaded_file() 函数机制理解不深而失败。从您提供的代码可见，问题核心在于两处关键错误：
❌ 错误一：$destination_path 被构造为 URL，而非服务器真实路径
// ❌ 错误写法（不可用于 move_uploaded_file） $destination_path = 'location:'.SITEURL.'images/category/'.$image_name;
move_uploaded_file() 的第二个参数必须是服务器本地的绝对或相对文件系统路径（如 /var/www/html/images/category/abc.jpg），而非带协议或重定向头的 URL 字符串（如 location:http://example.com/images/...）。'location:' 前缀不仅无效，还会导致路径非法，函数直接返回 false。
✅ 正确做法是使用相对于当前脚本或项目根目录的有效路径，推荐使用绝对路径提升健壮性：
// ✅ 推荐：基于 __DIR__ 构建绝对路径（更安全、可移植）
$upload_dir = __DIR__ . '/../images/category/';
if (!is_dir($upload_dir)) {
mkdir($upload_dir, 0755, true);
}
$destination_path = $upload_dir . basename($image_name);
❌ 错误二：move_uploaded_file() 参数顺序颠倒，且源路径错误
// ❌ 错误写法（第一个参数应为临时文件路径，不是原始文件名） $upload = move_uploaded_file($image_name, $destination_path);
$_FILES['images']['name'] 是客户端上传的原始文件名（如 logo.png），不能作为源文件路径；真正需要移动的是临时存储路径 $_FILES['images']['tmp_name']（如 /tmp/phpABC123）。
✅ 正确调用格式为：
// ✅ 源 = tmp_name，目标 = 有效服务器路径 $upload = move_uploaded_file($image_path, $destination_path);
✅ 完整修正后的上传逻辑（含基础校验）
<?php if (isset($_POST['submit'])) {
$title = mysqli_real_escape_string($conn, $_POST['title']);
$image_name = '';
$upload_success = true;
// 处理图片上传
if (!empty($_FILES['images']['name'])) {
$image_name = basename($_FILES['images']['name']);
$image_path = $_FILES['images']['tmp_name'];
$image_type = $_FILES['images']['type'];
$image_size = $_FILES['images']['size'];
// 基础校验：类型 & 大小（示例：仅允许 JPG/PNG，≤2MB）
$allowed_types = ['image/jpeg', 'image/jpg', 'image/png', 'image/gif'];
if (!in_array($image_type, $allowed_types)) {
$_SESSION['upload_image_category'] = "<div class='error'>仅支持 JPG、PNG、GIF 格式";
header('Location: ' . SITEURL . 'admin/add-category.php');
exit;
}
if ($image_size > 2 * 1024 * 1024) {
$_SESSION['upload_image_category'] = "<div class="error">图片大小不能超过 2MB</div>";
header('Location: ' . SITEURL . 'admin/add-category.php');
exit;
}
// 构建安全的目标路径（绝对路径）
$upload_dir = __DIR__ . '/../images/category/';
if (!is_dir($upload_dir)) {
if (!mkdir($upload_dir, 0755, true)) {
$_SESSION['upload_image_category'] = "<div class="error">上传目录创建失败</div>";
header('Location: ' . SITEURL . 'admin/add-category.php');
exit;
}
}
$destination_path = $upload_dir . $image_name;
// 执行移动
if (!move_uploaded_file($image_path, $destination_path)) {
$_SESSION['upload_image_category'] = "<div class="error">图片上传失败，请检查目录权限</div>";
header('Location: ' . SITEURL . 'admin/add-category.php');
exit;
}
}
// 获取其他字段值
$feature = isset($_POST['featureyon']) ? 'Yes' : 'No';
$active = isset($_POST['a_yes']) ? 'Yes' : 'No';
// 插入数据库（注意 SQL 注入防护）
$sql = "INSERT INTO tbl_category (title, image_name, featured, active)
VALUES (?, ?, ?, ?)";
$stmt = mysqli_prepare($conn, $sql);
mysqli_stmt_bind_param($stmt, 'ssss', $title, $image_name, $feature, $active);
$res = mysqli_stmt_execute($stmt);
if ($res) {
$_SESSION['add_category'] = "<div class="success">新分类添加成功！</div>";
header('Location: ' . SITEURL . 'admin/manage_category.php');
} else {
$_SESSION['add_category'] = "<div class="error">数据库插入失败：" . mysqli_error($conn) . "</div>";
header('Location: ' . SITEURL . 'admin/add-category.php');
}
}
?>
⚠️ 关键注意事项
-
权限检查：确保 Web 服务器用户（如
www-data或apache）对images/category/目录具有写权限（通常755或775）； -
enctype="multipart/form-data"：HTML 表单必须设置该属性，否则$_FILES为空； -
错误报告开启：开发阶段建议启用
error_reporting(E_ALL); ini_set('display_errors', 1);快速定位问题； - 安全性增强：生产环境应进一步校验文件扩展名（而非仅 MIME 类型）、重命名文件（防 XSS）、限制上传目录执行权限。
通过修正路径逻辑、规范函数参数、增加必要校验，即可稳定实现 PHP 图片上传与 MySQL 记录保存。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
