PHP 文件上传 – 来学习啦 – 编程乐园，实战驱动的编程学习平台

PHP 文件上传

天天向上

发布： 2025-03-19 22:30:06

原创

998 人浏览过

PHP 提供了一个非常方便的机制来处理文件上传，常用于用户上传图片、文档或其他类型的文件。通过 $_FILES 超全局变量，PHP 可以轻松接收并保存上传的文件。

以下是详细介绍和文件上传的流程。

1️⃣ HTML 文件上传表单

首先，您需要在 HTML 中创建一个表单，允许用户选择文件并提交。

<form action="upload.php" method="post" enctype="multipart/form-data">
    Select image to upload:
    <input type="file" name="fileToUpload" id="fileToUpload">
    <input type="submit" value="Upload Image" name="submit">
</form>

enctype="multipart/form-data"：此属性是必要的，它允许表单数据包含文件。没有它，表单无法提交文件。

2️⃣ PHP 文件上传处理

在表单提交后，PHP 将通过 $_FILES 超全局数组接收上传的文件。下面是一个简单的文件上传处理脚本。

`upload.php` 示例：

<?php
if ($_SERVER["REQUEST_METHOD"] == "POST") {
    // 获取文件信息
    $target_dir = "uploads/";  // 上传文件保存的目录
    $target_file = $target_dir . basename($_FILES["fileToUpload"]["name"]);  // 上传文件的目标路径
    $uploadOk = 1;  // 上传状态标志，0 表示失败，1 表示成功
    $imageFileType = strtolower(pathinfo($target_file, PATHINFO_EXTENSION));  // 获取文件扩展名

    // 检查文件是否为图片
    if (isset($_POST["submit"])) {
        $check = getimagesize($_FILES["fileToUpload"]["tmp_name"]);
        if ($check !== false) {
            echo "文件是一个图片 - " . $check["mime"] . ".<br>";
            $uploadOk = 1;
        } else {
            echo "文件不是图片。<br>";
            $uploadOk = 0;
        }
    }

    // 检查文件是否已存在
    if (file_exists($target_file)) {
        echo "抱歉，文件已存在。<br>";
        $uploadOk = 0;
    }

    // 限制文件大小（例如最大为 5MB）
    if ($_FILES["fileToUpload"]["size"] > 5000000) {  // 5MB
        echo "抱歉，您的文件太大。<br>";
        $uploadOk = 0;
    }

    // 只允许特定文件类型（例如：jpg、png、jpeg、gif）
    if ($imageFileType != "jpg" && $imageFileType != "png" && $imageFileType != "jpeg" && $imageFileType != "gif") {
        echo "抱歉，只有 JPG、JPEG、PNG 和 GIF 文件可以上传。<br>";
        $uploadOk = 0;
    }

    // 检查 `$uploadOk` 是否为 0（即上传失败）
    if ($uploadOk == 0) {
        echo "抱歉，您的文件未能上传。<br>";
    } else {
        // 如果一切正常，尝试上传文件
        if (move_uploaded_file($_FILES["fileToUpload"]["tmp_name"], $target_file)) {
            echo "文件 " . basename($_FILES["fileToUpload"]["name"]) . " 已上传。<br>";
        } else {
            echo "抱歉，上传文件时出错。<br>";
        }
    }
}
?>

3️⃣ 关键步骤解析

3.1 获取文件信息

PHP 通过 $_FILES 数组来访问上传文件的详细信息。这个数组包含多个子数组，其中主要的字段如下：

$_FILES["fileToUpload"]["name"]：上传文件的原始名称。
$_FILES["fileToUpload"]["type"]：上传文件的 MIME 类型。
$_FILES["fileToUpload"]["tmp_name"]：文件的临时存储路径。
$_FILES["fileToUpload"]["size"]：文件的大小（以字节为单位）。

3.2 文件检查

在实际上传文件之前，通常需要进行一些检查：

检查文件类型：可以使用 getimagesize() 函数检查文件是否是有效的图像文件。
检查文件大小：可以根据需要限制上传的文件大小（例如：不超过 5MB）。
检查文件是否已存在：避免覆盖同名文件。
文件扩展名检查：限制只允许特定类型的文件上传（如图片文件）。

3.3 保存文件

使用 move_uploaded_file() 函数将文件从临时目录移动到目标目录。

move_uploaded_file($_FILES["fileToUpload"]["tmp_name"], $target_file);

此函数会将上传的文件保存到指定的目标目录。

4️⃣ 文件上传的安全性考虑

虽然 PHP 提供了简单的文件上传功能，但由于安全原因，您需要注意以下几点：

4.1 限制文件类型

确保上传的文件是您期望的文件类型（例如：图片、PDF 文件等）。可以通过检查 MIME 类型或文件扩展名来限制上传类型。
避免直接执行上传的文件，例如不允许上传可执行的 PHP 文件。

4.2 限制文件大小

设置合适的文件大小限制，以防止用户上传过大的文件，消耗过多的服务器存储空间。
可以使用 $_FILES["fileToUpload"]["size"] 来限制文件大小。

4.3 隐藏上传目录

不要允许上传的文件在网页中直接访问。可以通过在服务器上对文件目录设置权限（如 .htaccess）来避免公开上传的文件。

4.4 文件名重命名

上传的文件可能有相同的文件名，考虑给文件重命名。可以使用 uniqid() 函数生成唯一的文件名，或者使用用户 ID 等信息。

$target_file = $target_dir . uniqid() . "." . $imageFileType;

5️⃣ 小结

PHP 文件上传机制非常强大，但开发者必须确保处理好文件的安全性、有效性和上传限制。通过 $_FILES 超全局变量，PHP 可以处理多种文件类型的上传，包括图像、文档等。对于实际开发，强烈建议对文件类型、大小等进行严格的验证。