ThinkPHP 6 执行原生 SQL 必须区分查用 Db::query()、改用 Db::execute()；混用会导致逻辑错误，如 query 执行 UPDATE 返回空数组却已修改数据；占位符仅防值注入，表名字段名等需白名单校验。
ThinkPHP 6 中执行原生 SQL，核心就两条路：查数据用 Db::query()，改数据用 Db::execute()。混用会出逻辑错乱——比如用 query 执行 UPDATE，返回空数组，但数据其实已改，极易埋雷。
查数据：Db::query() 返回结果数组
只适用于 SELECT、SHOW、EXPLAIN 等能返回结果集的语句。返回值是二维数组（每行一条记录），可直接遍历或传给模板。
- 问号占位符（推荐，简洁）：
Db::query('SELECT * FROM user WHERE status = ? AND id > ?', [1, 100]); - 命名占位符（语义清晰）：
Db::query('SELECT id,name FROM user WHERE role = :role', ['role' => 'admin']); - LIKE 模糊匹配要手动拼通配符：
['%' . $kw . '%']，不能写成?%，PDO 不识别 - 读写分离环境下，默认走从库；如需主库查询，加第三个参数
true：Db::query($sql, $params, true)
改数据：Db::execute() 返回影响行数
INSERT、UPDATE、DELETE、TRUNCATE 等写操作必须用它。返回整数（成功时为影响行数，失败为 false），不返回数据本身。
- 单条更新：
Db::execute('UPDATE user SET last_login = NOW() WHERE id = ?', [123]); - 批量插入（注意参数顺序一一对应）：
Db::execute('INSERT INTO log (uid, action, ip) VALUES (?, ?, ?), (?, ?, ?)', [1,'login','192.168.1.1', 2,'logout','192.168.1.2']); - 获取刚插入的 ID 需额外调：
Db::getLastInsID()，execute 本身不提供 - 误用 query 执行 DELETE 是典型翻车点：语句执行了，但返回
[]，容易误判为“没删成”
安全绑定：值可用占位符，表名字段名必须白名单校验
占位符只防「值」注入，对表名、字段名、ORDER BY 等动态部分无效。这些必须提前校验，严禁直拼。
立即学习“PHP免费学习笔记（深入）”；
- 错误示范：
ORDER BY ?→ 会被当字符串字面量，排序失效 - 正确做法：先白名单过滤再拼接，例如
$allowedSorts = ['id', 'name', 'create_time'];<br>if (!in_array($sortField, $allowedSorts)) { throw new \Exception('非法排序字段'); }<br>Db::query("SELECT * FROM user ORDER BY {$sortField} DESC"); - 表名占位
{:table}仅 ThinkPHP 语法糖，仍需校验：if (!in_array($table, ['user', 'order', 'log'])) { ... }
子查询：需手写或用 selectSub() 构建
query/execute 不解析嵌套结构，子查询必须自己写全 SQL 字符串，或借助查询构造器的 selectSub() 和 fieldRaw() 安全生成。
- 手写示例（注意括号与别名）：
Db::query('SELECT u.name FROM (SELECT id, name FROM user WHERE status = 1) AS u'); - 构造器方式更安全：
Db::table(Db::raw('(SELECT id,name FROM user WHERE status=1) AS u'))->field('name')->select(); - IN 子查询勿直接塞 buildSql 结果，应改用
whereRaw或闭包：->where('user_id', 'in', function($q) { $q->table('user')->where('status', 1)->field('id'); })
