PHP实现文件上传功能的完整教程与示例代码

gitbox 2025-08-04

PHP文件上传功能详解

在Web开发中，文件上传是非常常见的功能之一，尤其是在用户需要提交图片、文档或其他类型文件时。本文将通过简单易懂的示例，介绍如何在PHP中实现文件上传。

准备HTML表单

首先需要创建一个HTML表单，让用户可以选择要上传的文件。以下是一个基本的HTML上传表单代码：

<form action="upload.php" method="POST" enctype="multipart/form-data">
    <input type="file" name="fileToUpload" id="fileToUpload">
    <input type="submit" value="上传文件" name="submit">
</form>

表单中必须使用 enctype="multipart/form-data" 来支持文件上传。input type="file" 元素提供了文件选择的功能。

编写PHP上传脚本

用户提交表单后，文件将发送到服务器端脚本处理。以下是upload.php的示例代码：

<?php
$targetDirectory = "uploads/"; // 指定上传目录
$targetFile = $targetDirectory . basename($_FILES["fileToUpload"]["name"]); // 构建上传文件的完整路径

// 检查文件是否已存在
if (file_exists($targetFile)) {
    echo "文件已存在。";
} else {
    // 尝试上传文件
    if (move_uploaded_file($_FILES["fileToUpload"]["tmp_name"], $targetFile)) {
        echo "文件上传成功。";
    } else {
        echo "文件上传失败。";
    }
}
?>

上述脚本中，使用 $_FILES 变量获取上传文件的相关信息。basename() 函数用于提取原始文件名，而 move_uploaded_file() 函数则完成文件的移动与保存。