PHP表单递交控件名称含有点号(.)会被转化为下划线(_)的处理方法

江岸

发布时间：2026-10-14| 5人浏览过

原创

在PHP开发过程中，开发者有时会遭遇一个令人困惑的现象：前端HTML表单正常提交了数据，但在后端使用 $_POST 或 $_GET 接收参数时，却无法按预期获取到对应的键名。这通常是因为HTML表单控件的 name 属性中包含了点号（.）。PHP在处理这些请求时，会自动将名称中的点号转换为下划线（_），导致前后端变量名不匹配。

问题复现与测试环境

为了直观地观察这一行为，我们可以创建一个简单的 HTML 表单进行测试。以下代码包含了几种不同的命名方式，其中特别添加了带有特殊字符（如点号、竖线、连字符等）的输入框。

<html>
<head>
<title>测试表单提交</title>
</head>
<body>
<form action="" method="post">
名字:<input type="text" value="test" name="info.name" /><br/>
密码: <input type="text" value="hahaha" name="info.pwd" /><br/>
QQ: <input type="text" value="961412" name=".info.qq" /><br/>
住址: <input type="text" value="zhejiang" name="info|address" /><br/>
电话: <input type="text" value="123456789" name="1——phone" /><br/>
性别: <input type="radio" name="info_gender" value="1" checked>男 
      <input type="radio" name="info_gender" value="2">女<br/>
<button type="submit" name="submit" value="commit">Submit</button>
</form>
<?php
if ($_POST) {
    echo '<pre/>';
    var_export($_POST);
}
?>
</body>
</html>

当我们在浏览器中打开上述页面，并点击提交按钮后，PHP脚本会将接收到的所有 POST 数据进行打印。通过运行结果我们可以看到：所有在前端含有 . 的 key，在后端都变成了 _。

图1：PHP处理后的$_POST变量打印结果

从图中可以清晰地观察到：

输入框 name="info.name" 在后端变成了 'info_name' => 'test'
输入框 name="info.pwd" 在后端变成了 'info_pwd' => 'hahaha'
其他特殊符号如 | 或 -（取决于PHP版本和配置）处理方式可能不同，但点号的转换是默认且常见的行为。

原因解析：PHP的变量名规范化

这种行为的根本原因在于 PHP 的全局注册机制。当接收到 HTTP 请求时，PHP 需要将请求中的数据（如 GET/POST/Cookie）映射到全局变量数组（如 $_POST, $_GET, $_COOKIE）中。

然而，PHP 的变量命名有着严格的规则：

变量名必须以字母或下划线开头。
变量名只能包含字母、数字和下划线（a-z, A-Z, 0-9, _）。

由于 HTML 表单的 name 属性没有强制要求符合 PHP 变量的命名规范，开发者完全可以定义包含点号（如用于模拟对象路径）、空格或其他特殊字符的名称。为了防止非法的变量名直接污染全局作用域并引发致命错误，PHP 内核会在将数据填入 $_POST 数组之前，对键名进行“净化”处理：

核心规则： 所有的非字母、非数字字符（除了下划线）都会被替换为下划线 _。

因此，info.name 中的 . 不是合法的 PHP 变量字符（虽然它合法用于关联数组的键，但不合法用于动态生成的普通变量名，此处主要是为了统一规范化处理），于是被替换成了 _，最终形成了 info_name。

排查与解决方案

当你在后端调试发现获取不到预期的表单数据时，可以按照以下步骤进行排查和处理：

第1步：验证变量名差异

不要直接假设后端的键名与前端一致。在代码中添加 var_dump($_POST) 或 print_r($_POST)，查看实际接收到的键名到底是什么。很多时候，你会发现原本预期的 user.email 实际上变成了 user_email。

第2步：调整前端命名规范（推荐）

为了避免混淆和潜在的兼容性问题，最安全的做法是在设计表单时，就遵循 PHP 的变量命名习惯。尽量只使用小写字母、数字和下划线。name 属性中应避免使用点号（.）、空格或其他特殊标点符号。

错误示范： <input name="user.first_name" />
正确示范： <input name="user_first_name" />

第3步：后端适配（次选方案）

如果必须保留带有特殊字符的名称，或者使用的是第三方库生成的不可控表单结构，你可以通过正则表达式或字符串替换在后端手动还原，但这增加了维护成本。例如，如果你能确定只有点号需要转换回来：

$original_post = array();
foreach ($_POST as $key => $value) {
    // 将下划线换回点号（视具体需求而定）
    $original_key = str_replace('_', '.', $key);
    $original_post[$original_key] = $value;
}
// 现在可以使用 $original_post['user.name'] 来获取数据

注意：这种方法仅在你知道确切的前端格式时才推荐使用，因为它可能会意外地将原本就使用下划线的变量也转换掉。