使用 PHP 处理文件上传错误并在表单中显示-html教程-PHP中文网

使用 PHP 处理文件上传错误并在表单中显示

花韻仙語

发布： 2025-08-21 20:46:20

原创

249人浏览过

使用 php 处理文件上传错误并在表单中显示

这段代码演示了如何在 PHP 文件上传过程中捕获错误，并将这些错误信息清晰地显示在对应的文件上传输入框旁边。通过使用数组来存储错误信息，并结合 HTML 结构，可以有效地向用户反馈上传失败的原因，从而提升用户体验。

错误处理与显示

在处理文件上传时，及时有效地向用户反馈错误信息至关重要。PHP 的 $_FILES 数组包含了文件上传过程中的所有信息，包括错误代码。我们需要利用这些信息来判断上传是否成功，并在失败时将错误信息传递到前端进行显示。

后端 PHP 代码

以下代码展示了如何处理文件上传错误，并将错误信息存储在 $errors 数组中：

<?php

if ($_SERVER["REQUEST_METHOD"] == "POST" && !empty($_FILES['images'])) {
    // 文件上传配置
    $allowTypes = array('jpg', 'png', 'jpeg', 'gif');

    $images_arr = array();
    $errors = array(); // 初始化错误数组

    foreach ($_FILES['images']['name'] as $key => $val) {
        $image_name = $_FILES['images']['name'][$key];
        $tmp_name = $_FILES['images']['tmp_name'][$key];
        $size = $_FILES['images']['size'][$key];
        $type = $_FILES['images']['type'][$key];
        $error = $_FILES['images']['error'][$key];

        $fileType = pathinfo($image_name); // split path in its components
        $extension = strtolower($fileType['extension']); // extract the extension and normalize to lowercase

        if (in_array($extension, $allowTypes)) {

            if ($error === 0) {

                $fileNameNew = uniqid('', true) . "." . $extension;
                $fileDestination = 'user_images/' . $fileNameNew;

                if (move_uploaded_file($tmp_name, $fileDestination)) {
                    // 上传成功，可以进行其他操作
                } else {
                    $errors[$key] = "文件移动失败，请检查目录权限。";
                }

            } else {
                // 根据错误代码设置错误信息
                switch ($error) {
                    case UPLOAD_ERR_INI_SIZE:
                        $errors[$key] = "文件大小超过服务器限制。";
                        break;
                    case UPLOAD_ERR_FORM_SIZE:
                        $errors[$key] = "文件大小超过表单限制。";
                        break;
                    case UPLOAD_ERR_PARTIAL:
                        $errors[$key] = "文件只上传了一部分。";
                        break;
                    case UPLOAD_ERR_NO_FILE:
                        $errors[$key] = "没有选择任何文件。";
                        break;
                    case UPLOAD_ERR_NO_TMP_DIR:
                        $errors[$key] = "找不到临时文件夹。";
                        break;
                    case UPLOAD_ERR_CANT_WRITE:
                        $errors[$key] = "文件写入失败。";
                        break;
                    case UPLOAD_ERR_EXTENSION:
                        $errors[$key] = "PHP 扩展阻止了文件上传。";
                        break;
                    default:
                        $errors[$key] = "未知上传错误。";
                        break;
                }
            }

        } else {
            $errors[$key] = "不允许上传该类型的文件。请使用 jpg/jpeg/png/gif 格式的文件。";
        }
    }
}
?>

登录后复制

关键点：

立即学习“PHP免费学习笔记（深入）”；

初始化错误数组： 在循环之前，需要初始化 $errors = array();，用于存储每个文件上传的错误信息。
错误代码判断： $_FILES['images']['error'][$key] 包含了错误代码。可以使用 switch 语句根据不同的错误代码设置相应的错误信息。
数组索引： 使用 $key 作为 $errors 数组的索引，这样可以确保错误信息与对应的文件上传输入框关联起来。

前端 HTML 代码

以下代码展示了如何在 HTML 表单中显示错误信息：

表单大师AI

一款基于自然语言处理技术的智能在线表单创建工具，可以帮助用户快速、高效地生成各类专业表单。

查看详情

<form action="" method="post" enctype="multipart/form-data">
    <div>
        <input type="file"  name="images[]" >
        <div class="error_highlight"><?php if (isset($errors[0])) echo $errors[0]; ?></div>
    </div>

    <div>
        <input type="file"  name="images[]" >
        <div class="error_highlight"><?php if (isset($errors[1])) echo $errors[1]; ?></div>
    </div>

    <div>
        <input type="file"  name="images[]" >
        <div class="error_highlight"><?php if (isset($errors[2])) echo $errors[2]; ?></div>
    </div>

  <input type="submit" name="submit" value="Upload all files">
</form>

登录后复制

关键点：

立即学习“PHP免费学习笔记（深入）”；