PHP move_uploaded_file() 函数详解：上传文件安全移动指南

move_uploaded_file() 函数简介

在PHP中，move_uploaded_file() 函数用于将上传的文件从临时目录移动到指定的新位置。它是处理用户上传文件（如图片、文档等）时的常用函数，能够有效管理上传文件的存储。

函数语法如下：

<span class="fun">bool move_uploaded_file(string $filename, string $destination)</span>

其中，$filename 是上传文件的临时路径，$destination 是目标路径。函数执行成功返回 true，失败返回 false。

如何使用 move_uploaded_file() 移动上传文件

确保上传文件存在

在调用 move_uploaded_file() 之前，需要先验证上传的文件是否存在且无错误。可以通过 $_FILES 数组来检查文件信息。

$file_tmp = $_FILES['file']['tmp_name'];
if (!file_exists($file_tmp)) {
    echo "上传文件不存在！";
    exit;
}

检查并创建目标文件夹

移动文件前，应确保目标目录存在。如果目录不存在，可以使用 mkdir() 创建，并设置合适的权限。

$destination = "uploads/";
if (!is_dir($destination)) {
    mkdir($destination, 0777, true);
}

执行文件移动操作

确认上传文件和目标目录后，即可使用 move_uploaded_file() 进行移动操作，判断返回结果以确定成功与否。

$filename = $_FILES['file']['name'];
$destination_path = $destination . $filename;
if (move_uploaded_file($file_tmp, $destination_path)) {
    echo "文件移动成功！";
} else {
    echo "文件移动失败！";
}

使用注意事项

设置文件夹权限

为了确保上传文件能顺利保存，目标文件夹必须具备读写权限。可以通过 chmod() 函数调整权限。

<span class="fun">chmod($destination, 0777);</span>

这将赋予目录读、写、执行权限，方便文件管理。

避免文件覆盖

当目标文件夹已有同名文件时，move_uploaded_file() 会直接覆盖原文件。建议在移动文件前先检测目标路径是否存在同名文件。

$filename = $_FILES['file']['name'];
$destination_path = $destination . $filename;
if (file_exists($destination_path)) {
    echo "文件已存在！";
    exit;
}

总结

本文详细介绍了 PHP 的 move_uploaded_file() 函数使用流程，涵盖了文件存在性检查、目标目录管理、权限设置及文件覆盖预防等关键环节。掌握这些内容，能帮助开发者更安全、有效地处理文件上传操作。