PHP 接收表单数据：POST、GET 与 filter_input 三种思路与避坑清单

PHP 接收表单数据只有三条路：用 $_POST 收 POST 表单、用 $_GET 收 URL 参数、用 filter_input 顺手做过滤校验，选哪条取决于表单的 method 与是否要防注入。刚接触 PHP 表单处理的新手常因 method 不匹配、漏写 name、编码不统一而取不到值或中文乱码。本文用一份可复制的最小示例，把三种思路的边界（method 必须匹配、数组字段、文件字段）一次讲清，并给出未取到值、乱码、表单属性写错时的排错清单。先确认你的 PHP 环境能跑，再照示例验证结果是否与预期一致。

PHP 接收表单数据的三种思路对比图，展示 POST、GET 与 filter_input 的用法差异

一、先看结论：PHP 接收表单数据怎么选

理解表单提交方式是选对接收变量的前提。下面这张表直接给出选择顺序，避免你在不该用的地方踩坑。实际运行前，先把表单的 method 与处理脚本的接收变量对上号，这是九成取不到值的根因。若你只是本地练手，任选一种跑通即可；若要做成线上功能，优先把防注入放进接收环节。三种思路并不互斥，同一个页面里也能按字段混用，关键是每个字段都清楚自己走哪条路。

思路	适用场景	注意点
`$_POST` 接收 POST 表单	提交密码、长文本、文件等敏感或大量数据	表单 `method` 必须为 `post`，数组字段用 `name="x[]"`
`$_GET` 接收 URL 参数	搜索、分页、可分享的查询链接	参数暴露在地址栏，长度受限，不适合敏感数据
`filter_input` 过滤校验	既要取值又要防注入、规范格式	校验失败返回 `false`，需单独判断再使用

三种思路的适用场景与边界对比图

如果你只想快速拿到数据，普通表单用 $_POST 就够了；但要处理外部输入、担心注入，优先用 filter_input 顺手过滤。超全局数组的字段含义可随时翻 PHP 速查手册核对。

二、环境确认与最小示例

写代码前先确认运行环境，能少走很多弯路。本文示例基于 PHP 7.4 及以上，用命令行 php -v 检查版本；如果你还没装 PHP，先按官方文档完成安装与配置，再回来跑下面的脚本。版本差异主要体现在过滤函数行为上，PHP 8 对部分废弃特性更严格，建议本地先用 PHP 教程过一遍基础。

配置阶段还有一个易忽略的点：PHP 的 php.ini 里 post_max_size 与 upload_max_filesize 会限制 POST 体和上传大小，超过就被静默截断，表现为 $_POST 或 $_FILES 部分字段莫名缺失。排查时先核对这两个值，再确认表单 enctype 是否正确。运行环境就绪后，建议把下面的最小示例原样复制，先验证能输出预期名字，再逐步替换成你自己的字段，这样能最快定位是环境问题还是代码问题。

下面是一段能直接跑的最小示例，既显示表单，又在处理端接收提交的名字：

<?php
// 先检查请求方法，避免首次直接访问时读空数组报错
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 用 filter_input 取 username，顺便做字符串过滤
    $name = filter_input(INPUT_POST, 'username', FILTER_SANITIZE_STRING);
    // 输出前用 htmlspecialchars 防 XSS
    echo '你提交的名字是：' . htmlspecialchars($name);
}
?>
<!-- 表单：method 必须是 post，才能用 $_POST 接收 -->
<form method="post" action="">
    名字：<input type="text" name="username">
    <input type="submit" value="提交">
</form>

未在本机执行，预期结果为：填写「小明」并提交后，页面输出「你提交的名字是：小明」。若执行后空白，先检查表单 method 与处理脚本是否一致；若报 Undefined index，说明没判断请求方法就直接读数。想本地快速试，可把脚本贴到在线运行环境验证输出。

三、思路一：$_POST 接收 POST 表单（最常用）

$_POST 是超全局数组，专门接收 method="post" 的表单字段。POST 请求把数据放在请求体里，地址栏不可见，因此适合提交密码、长文本与文件。掌握 PHP 表单处理的基本流程后，再谈安全过滤会更顺手。

数组字段的读取要养成用 ?? 给默认值的习惯，否则用户没勾选时直接读取会触发 Undefined array key 警告。文件字段除了 $_FILES，还要注意 tmp_name 只是临时路径，必须用 move_uploaded_file 落到正式目录，直接读临时路径在请求结束后就消失了。把这些边界写进接收代码，比事后逐个排错省事得多，也能避免线上出现偶发的字段丢失。

<?php
// 仅当请求方法是 post 时才处理，避免直接访问报错
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 普通字段：直接用键名读取，$_POST 里存的是字符串
    $username = $_POST['username'] ?? '';

    // 数组字段：表单写 name="hobby[]"，这里拿到的是数组
    $hobbies = $_POST['hobby'] ?? [];

    // 文件字段：不走 $_POST，要去 $_FILES 里取
    $fileName = $_FILES['avatar']['name'] ?? '';
}
?>

边界提醒：文件上传必须用 method="post" 且表单加 enctype="multipart/form-data"，否则 $_FILES 为空；复选框、多选列表想一次拿多个值，控件 name 必须写成 name="x[]"。另外 $_POST 默认只对 application/x-www-form-urlencoded 与 multipart/form-data 生效，用 text/plain 提交时数据不会被解析进 $_POST，这是新手常踩的隐藏失败点。

四、思路二：$_GET 接收 URL 参数（适合搜索/分页）

$_GET 接收拼在 URL 后面的查询参数，表单 method="get" 时字段会被自动拼到地址栏。表单提交方式选 get 的核心好处是链接可分享、可收藏，适合搜索与分页这类非敏感场景。

<?php
// GET 数据来自 URL 查询字符串，判断请求方法后用 $_GET 读取
if ($_SERVER['REQUEST_METHOD'] === 'GET') {
    // 例如访问 search.php?q=php，用 $_GET['q'] 拿到关键词
    $keyword = $_GET['q'] ?? '';
    echo '搜索关键词：' . htmlspecialchars($keyword);
}
?>
<!-- 表单 method=get 时，字段会拼到 URL 上，链接可分享 -->
<form method="get" action="search.php">
    <input type="text" name="q">
    <input type="submit" value="搜索">
</form>

适用边界：GET 参数长度受浏览器和服务器限制（通常 2KB~8KB），且完全暴露在地址栏，密码、token 这类敏感数据绝不能走 GET。若需在地址栏传递中文，记得用 urlencode 处理，接收端再用 urldecode 还原，避免中文乱码。实测时把中文直接拼进 URL 往往变成一串百分号编码，这是正常现象，不是输出错误。

GET 还常用于接口式调用，比如前端用 fetch 拼查询参数请求后端，服务端同样用 $_GET 接收。此时要留意参数名与前端完全一致，大小写、下划线都不能错，否则拿到的是空值。若中文在地址栏出现乱码，优先确认发送端 encodeURIComponent 与接收端 urldecode 成对出现，而不是盲目改页面编码，否则只修一边还是会乱。

五、思路三：filter_input 过滤校验与常见排错

filter_input 在取值的同时做类型与格式校验，比直接读 $_POST 更安全，特别适合处理外部输入。关于不同语言的输入处理差异，可对照 PHP 与多语言对比理解。

除了邮箱，filter_input 还支持 FILTER_VALIDATE_INT、FILTER_VALIDATE_URL 等规则，能顺手把类型也校验了。需要强调：校验失败返回 false 而不是空字符串，所以比较时必须用 === false 判断，用 == 会把 0 或空串误判成失败。把校验结果先存进变量再使用，能避免重复调用和逻辑错乱，也让排错时一眼看清到底是取值为空还是校验未过。

<?php
// 第三个参数是过滤规则；校验失败返回 false，而不是空字符串
$email = filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL);
if ($email === false) {
    // 校验失败：邮箱格式不合法，给出提示并修复后再用
    echo '邮箱格式错误';
} else {
    echo '邮箱合法：' . $email;
}
?>

遇到问题时，按下面的清单排查：

现象	常见原因	修复方向
`$_POST`/`$_GET` 取不到值，是空	表单 `method` 与接收方式不匹配，或 `<input>` 漏写 `name`	核对 `method=post` 配 `$_POST`，且每个字段都有 `name`
中文变成乱码（如 `å“ˆ`）	页面编码与提交编码不一致，未声明 UTF-8	在 `<head>` 加 `<meta charset="utf-8">`，PHP 端 `header('Content-Type: text/html; charset=utf-8')`
提交后报 `Undefined index`	直接访问页面、未判断请求方法就读取数组	先用 `$_SERVER['REQUEST_METHOD']` 判断，或改用 `??` 给默认值

总结

PHP 接收表单数据的核心结论很清晰：普通 POST 表单用 $_POST，可分享的查询用 $_GET，要防注入就上 filter_input。选型时先确认表单的 method 与字段 name，再写最小示例验证，最后对照排错表处理失败。把 method 匹配、数组字段、文件字段这几个边界记牢，能避开绝大多数新手坑。

延伸学习

在编程狮系统学完 PHP 基础后，再回头看这份排错清单会更轻松：

PHP 零基础课程

常见问题

Q：$_POST 里为什么取不到表单值？

A：最常见是表单 method 写成了 get 却用 $_POST 接收，或 <input> 漏写了 name 属性。先检查表单 method 与接收变量是否一致，再确认每个字段都有 name。

Q：中文提交后变成乱码怎么修复？

A：这是编码不一致导致的。在 HTML 的 <head> 里加 <meta charset="utf-8">，PHP 处理前用 header('Content-Type: text/html; charset=utf-8') 声明输出编码，并保证文件本身以 UTF-8 无 BOM 保存。

Q：filter_input 和直接读 $_POST 有什么区别？

A：filter_input 能在取值的同时做类型与格式校验，校验失败返回 false，更适合处理外部输入防注入；直接读 $_POST 只是原样取值，不做任何过滤，需要自己再 sanitize。

Q：复选框和多选框如何一次拿到多个值？

A：把控件的 name 写成数组形式，例如 name="hobby[]"，PHP 端用 $_POST['hobby'] 拿到的就是数组，再用 foreach 遍历即可。注意若用户一个都不勾，$_POST 里不会有该键，需用 ?? [] 兜底，避免遍历时报错。