whereRaw()是高危入口,因跳过参数绑定直接拼接SQL;仅支持?占位符顺序绑定,不支持命名参数;字段/表名等结构部分须白名单校验,不可用占位符;调试需用getLastSql()确认绑定效果。

whereRaw() 为什么是高危入口?
因为 whereRaw() 完全跳过 ThinkPHP 的参数绑定机制,直接把字符串拼进 SQL —— 即使只拼一个 $id,写成 whereRaw("status = " . input('s')) 就等于给攻击者开了后门。它不校验、不转义、不预处理,只负责“原样塞进去”。
必须用问号占位符,且只支持顺序绑定
whereRaw() 支持问号占位符(?),但不支持命名参数(如 :status);它的第二个参数必须是索引数组,PDO 按顺序绑定值,和 SQL 中 ? 出现的次序严格对应。
-
whereRaw('age > ? AND type IN (?)', [$minAge, $types])✅$types是数组时会自动展开为(?, ?, ?)并逐个绑定 -
whereRaw('name = :name', ['name' => $n])❌ 不生效,命名参数被忽略,:name当作字面量留在 SQL 里 -
whereRaw('id = ?', [input('id')])✅ 安全,哪怕input('id')是字符串,也会被当参数绑定
字段名/表名/函数名不能用占位符,必须白名单校验
占位符只适用于“值”,不适用于 SQL 结构部分。比如想动态指定排序字段或条件字段,不能写 whereRaw(input('clause')),也不能写 whereRaw('?? = ?', [$field, $value]) —— ?? 不被识别,TP6 不支持字段占位符。
- 动态字段必须映射:例如
$fieldMap = ['u' => 'username', 'e' => 'email']; $realField = $fieldMap[input('f')] ?? 'username'; - 排序方向必须限定:
$dir = in_array(input('d'), ['asc', 'desc']) ? input('d') : 'asc'; - 绝对禁止把用户输入直接拼进
whereRaw()字符串开头或中间,比如"{$userInput} = ?"
调试时别 echo,用 getLastSql() 看真实语句
写完 whereRaw() 后,不要靠肉眼判断是否安全。执行前加一句 echo $query->getLastSql(); die;,确认最终 SQL 里所有用户数据都已被替换成问号绑定后的值,且没有意外多出单引号、括号或分号。
最容易被忽略的是:你以为传了数组就安全,但若数组里混进了未过滤的键名(比如 ['order' => input('sort')] 被用于构造 ORDER BY),whereRaw() 不拦、模型不拦、PDO 也不拦 —— 那段字符串根本没进绑定流程。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











