ThinkPHP 5.1 支持问号和命名占位符绑定，但不可混用；TP6.x 绑定更严格，默认字符串处理，需显式指定参数类型，且预处理语句复用可能导致类型冲突，Db::raw() 不参与绑定。
ThinkPHP 5.1 中 query 和 execute 绑定参数用法
TP5.1 默认使用 PDO，支持问号占位符和命名占位符两种方式，但命名占位符必须配对且不能混用。常见错误是传入数组却用了问号占位符，导致参数没被绑定，SQL 直接拼接进去了。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 问号占位符：用
query('SELECT * FROM user WHERE id = ? AND status = ?', [1, 'active'])，参数顺序严格对应 - 命名占位符：用
query('SELECT * FROM user WHERE id = :id AND status = :status', ['id' => 1, 'status' => 'active'])，键名必须和:xxx完全一致 - 别在
execute（增删改）里漏掉返回值判断：$result = $this->query(...); if (false === $result) { /* 失败 */ } - 注意：TP5.1 的
Db::raw()不参与参数绑定，写在里面的内容会被原样插入，容易引发注入
ThinkPHP 6.x 中 query / execute 的绑定限制更严格
TP6 默认关闭了自动参数类型推断，所有绑定参数默认按字符串处理。如果你查的是 id = ?，传整数 123 没问题；但若字段是数字类型且数据库开启了 strict mode，PDO 可能报 HY000 错误。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 显式指定参数类型：用
query('SELECT * FROM user WHERE id = ?', [123], [\PDO::PARAM_INT]) - 命名占位符不支持嵌套或动态键名，
[':'. $key => $val]这种拼接写法会失效 -
Db::table('user')->whereRaw('id = ?', [123])->select()是合法的，但whereRaw本身不校验绑定，靠外层 QueryBuilder 转义，不如直接用where('id', 123) - TP6.3+ 开始，
query方法第二个参数如果是对象（如new \think\db\Query），会静默忽略绑定 —— 别传错类型
跨版本迁移时最常踩的坑：预处理语句复用与连接状态
TP5.1 默认每个 query 都新建预处理语句，TP6.x 则尝试复用（基于 SQL 字符串哈希）。这意味着相同 SQL 字符串、不同参数类型（比如一次传 '1'，一次传 1），在 TP6 下可能触发 PDO 类型冲突错误，而 TP5.1 不会。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 避免在循环中高频调用同一 SQL 字符串但参数类型不一致的
query，尤其涉及IN (?)场景 —— 改用where IN构建器更稳 - 手动清空预处理缓存：TP6 可调
Db::getPdo()->prepare($sql)->closeCursor()，但没必要，优先重构逻辑 - 连接断开后（如超时），TP6 的复用缓存不会自动失效，下次执行可能抛
SQLSTATE[HY000]: General error—— 加个简单重试逻辑比修缓存更实际
为什么不用 Db::raw() 做参数绑定
Db::raw() 的设计目标是绕过框架转义，插入原始 SQL 片段。它从不解析或绑定任何参数，所谓“传数组进去自动绑定”是误解。你写 Db::raw('id = ? ', [123])，那个 [123] 根本不会被消费，只是被丢弃。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 需要绑定就老实用
query或execute，别试图把raw当绑定入口 - 真要拼接动态字段名或表名（非参数），必须白名单校验：
in_array($field, ['name', 'email', 'status'])，然后用raw - TP6 中
raw返回的是Raw对象，若误塞进where条件又没配合exp，会触发Call to a member function parseKey() on string
事情说清了就结束。真正麻烦的不是语法差异，而是不同版本对“同一个 SQL 字符串”的预处理行为是否一致 —— 这点连官方文档都藏得深。
