PHP PDO中bindValue含点号占位符失效问题咨询

问题场景 #

使用PDO的bindValue绑定带点号的占位符时会报错，示例代码：

$key = ":where_user_setores.setor_id_0";
$value = 2;

$sth->bindValue($key, $value, PDO::PARAM_INT);

报错信息：

SQLSTATE[HY093]: Invalid parameter number: parameter was not defined

换成不带点号的占位符（比如:where_setor_id_0）就能正常运行，目前临时用md5($key)生成无点号的唯一占位符上线，但有两个疑问：

1. 为啥带点号的占位符会让bindValue失效？
2. 要是两张表有相同列名，难道没法用bindValue处理？
3. 查了文档没找到占位符的创建限制，求解释。

原因及解决方案 #

1. 点号占位符失效的核心原因 #

PDO的命名占位符遵循SQL标识符的命名规则，点号在SQL里是用来分隔表名和列名的（比如user.id），PDO会把带点号的占位符误解析成「表名.参数名」的结构，而不是一个完整的占位符。比如你绑定:where_user_setores.setor_id_0时，PDO会认为你要绑定的是setor_id_0这个参数，但你的SQL语句里根本没定义这个参数，自然就报「参数未定义」的错了。

2. 多表同列名的正确处理方式 #

多表有同名字段时，不用把表名加到占位符里，而是在SQL的字段引用里加表前缀，占位符保持简洁唯一就行。举个例子：

SELECT u.name, p.name 
FROM users u 
JOIN profiles p ON u.profile_id = p.id 
WHERE u.id = :user_id AND p.id = :profile_id

然后绑定对应的占位符：

$sth->bindValue(':user_id', 15, PDO::PARAM_INT);
$sth->bindValue(':profile_id', 7, PDO::PARAM_INT);

这样既区分了同名字段，又符合PDO的规则，不会出问题。

3. 占位符的隐含规则 #

PDO的命名占位符只能包含字母、数字和下划线，不能用点号、连字符这类特殊字符——这点虽然有些官方文档没明确写，但属于SQL解析的隐含规则，因为特殊字符会被当成SQL语法结构的一部分，而不是占位符的组成部分。

内容的提问来源于stack exchange，提问作者José Victor