HTML 表单提交到 PHP 的三种方式：enctype 三种值的真实场景踩坑

引子：表单提交的那些坑，上周三 10:00 我又踩了一次

上周三 10:00，我手上这台跑着 PHP 8.2.18 / Ubuntu 22.04 / MySQL 8.0.36 的服务器，突然开始拒绝用户上传图片。查了下日志，发现是 PHP 报错 “unexpected EOF”。一通排查后，发现是表单 enctype 设置错误。这篇就来聊聊 HTML 表单提交到 PHP 的三种 enctype 方式，以及我踩过的那些坑。

测试环境声明

测试环境：

• PHP 8.2.18
• Ubuntu 22.04
• MySQL 8.0.36
• Nginx 1.18.0

HTML 表单提交的三种 enctype 值

HTML 表单的 enctype 属性指定了表单数据在提交到服务器时的编码方式。主要有三种值：

• application/x-www-form-urlencoded（默认）
• multipart/form-data
• text/plain

1. application/x-www-form-urlencoded

这是表单的默认编码方式。它会将表单数据编码为 URL 编码的格式，适用于大多数文本数据提交。

  
<form action="submit.php" method="post">  
  <input type="text" name="username">  
  <input type="submit" value="Submit">  
</form>  

在这种情况下，PHP 会通过 $_POST 接收数据。

2. multipart/form-data

当表单包含文件上传时，必须使用 multipart/form-data。它会将表单数据分割成多个部分，每个部分对应一个表单字段或文件。

  
<form action="upload.php" method="post" enctype="multipart/form-data">  
  <input type="file" name="upload">  
  <input type="submit" value="Upload">  
</form>  

上周三的坑就出在这里。当时表单是这样写的：

  
<form action="upload.php" method="post">  
  <input type="file" name="upload">  
  <input type="submit" value="Upload">  
</form>  

结果 PHP 报错 “unexpected EOF”。这是因为没有指定 enctype，浏览器默认使用 application/x-www-form-urlencoded，而文件上传需要 multipart/form-data。

3. text/plain

这种编码方式会将表单数据作为纯文本发送，不进行任何编码。它很少使用，主要用于调试。

  
<form action="submit.php" method="post" enctype="text/plain">  
  <input type="text" name="username">  
  <input type="submit" value="Submit">  
</form>  

在这种情况下，PHP 会通过 $HTTP_RAW_POST_DATA 或 php://input 接收数据。

排查过程：一步步揪出 enctype 的问题

回到上周三的问题。当我看到 “unexpected EOF” 时，第一反应是检查 Nginx 和 PHP-FPM 的日志。

  
$ tail -f /var/log/nginx/error.log  

日志显示 PHP 解析请求时出错。接着我查看了 PHP-FPM 的日志：

  
$ tail -f /var/log/php8.2-fpm.log  

发现是 “unexpected EOF” 错误。这通常意味着请求数据不完整或格式不正确。

然后我检查了表单的 HTML 代码，发现没有指定 enctype。浏览器默认使用 application/x-www-form-urlencoded，而文件上传需要 multipart/form-data。

根因 & 解决：enctype 正确设置是关键

根因是表单没有正确设置 enctype，导致 PHP 无法正确解析文件上传数据。

解决方法很简单，就是在表单中指定 enctype=”multipart/form-data”。

  
<form action="upload.php" method="post" enctype="multipart/form-data">  
  <input type="file" name="upload">  
  <input type="submit" value="Upload">  
</form>  

此外，在 PHP 中处理文件上传时，需要确保 PHP 配置允许文件上传，并且上传的文件大小不超过 upload_max_filesize 和 post_max_size 的限制。

以下是 PHP 处理文件上传的示例代码：

  
<?php  
if ($_SERVER['REQUEST_METHOD'] === 'POST') {  
    if (isset($_FILES['upload'])) {  
        $upload = $_FILES['upload'];  
        if ($upload['error'] === UPLOAD_ERR_OK) {  
            $uploadedPath = '/path/to/upload/directory/' . basename($upload['name']);  
            if (move_uploaded_file($upload['tmp_name'], $uploadedPath)) {  
                echo "File uploaded successfully.";  
            } else {  
                echo "Failed to move uploaded file.";  
            }  
        } else {  
            echo "Upload error: " . $upload['error'];  
        }  
    } else {  
        echo "No file uploaded.";  
    }  
}  
?>  

小结

HTML 表单提交到 PHP 时，enctype 的设置至关重要。默认的 application/x-www-form-urlencoded 无法处理文件上传，必须使用 multipart/form-data。血书建议：每次处理文件上传时，务必明确指定 enctype，否则就会像我上周三那样，踩进同一个坑。

踩坑清单

• 没指定 enctype，文件上传必挂。血书建议：每次都明确写上 multipart/form-data。
• 上传文件大小超限，PHP 会报错。检查 upload_max_filesize 和 post_max_size 配置。
• 没检查 $_FILES 数组，直接访问文件信息会出错。务必先确认文件上传成功。
• 权限问题：上传目录要有写权限，否则文件无法保存。
• 忘了处理文件类型和大小验证，导致安全问题。切记：永远不要信任用户上传的数据。