本文详解 pdo 命名占位符与问号占位符在 php 数据库插入操作中的关键区别，重点解决“invalid parameter number”错误，并提供可直接运行的修复代码与最佳实践建议。
在使用 PHP 通过 PDO 向 MySQL 数据库插入表单数据时，一个常见却极易被忽视的错误是：PDOStatement::execute(): SQLSTATE[HY093]: Invalid parameter number: number of bound variables does not match number of tokens。该错误并非数据库连接或字段名问题，而是参数绑定方式与占位符类型不匹配所致。
根本原因在于：你声明的是命名占位符（如 :adresse, :ouverture），却试图用索引数组（即 array($_POST['a'], $_POST['b']...)）执行绑定——PDO 无法将位置顺序映射到名称，因此抛出参数数量不匹配异常。
✅ 正确做法一：保持命名占位符，改用关联数组传参（推荐，语义清晰、易于维护）：
$sqlQuery = 'INSERT INTO succursale(adresse, ouverture, fermeture, ouvert_raison)
VALUES (:adresse, :ouverture, :fermeture, :ouvert_raison)';
$req = $conn->prepare($sqlQuery);
$req->execute([
':adresse' => $_POST['adresse'] ?? '',
':ouverture' => $_POST['ouverture'] ?? '',
':fermeture' => $_POST['fermeture'] ?? '',
':ouvert_raison' => $_POST['ouvert_raison'] ?? ''
]);✅ 正确做法二：改用问号占位符（?），配合索引数组（简洁，适合简单场景）：
$sqlQuery = 'INSERT INTO succursale(adresse, ouverture, fermeture, ouvert_raison)
VALUES (?, ?, ?, ?)';
$req = $conn->prepare($sqlQuery);
$req->execute([
$_POST['adresse'] ?? '',
$_POST['ouverture'] ?? '',
$_POST['fermeture'] ?? '',
$_POST['ouvert_raison'] ?? ''
]);? 重要注意事项：
- 始终对 $_POST 数据做空值判断（如 ?? ''）或过滤（如 filter_input()），避免 undefined index 警告及潜在注入风险；
- 命名占位符的键名必须带冒号前缀（:adresse），且大小写严格匹配；
- 不要混用两种风格（例如命名占位符 + 索引数组），这是导致 HY093 错误的主因；
- 生产环境务必启用 PDO 错误模式为异常：$conn->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);，便于及时捕获并调试数据库错误。
? 小结：PDO 的安全性依赖于「占位符类型」与「执行参数结构」的一致性。选择命名占位符就用关联数组，选择问号占位符就用索引数组——二者不可交叉。清晰的命名语义和严格的参数映射，是构建健壮 Web 数据操作的基础。
