ThinkPHP 5.1+ 的 scope 方法必须为 public static，首参固定为 $query，不返回值；传参仅支持 User::scope('name', $val) 或 User::scope(['name' => $val])；多 scope 顺序影响 SQL 逻辑；scope 内不可执行 select 或原生拼接 SQL。
scope方法必须声明为public static
ThinkPHP 5.1+ 要求所有 scope 方法必须是 public static，否则调用时会静默失败或报 Fatal error。常见错误是只写 public function scopeHot，漏掉 static 关键字，结果 User::scope('hot')->select() 返回空或直接报错。
正确写法示例：
public static function scopeHot($query, $min = 1000)
{
$query->where('status', 1)->where('views', '>=', $min);
}
- 第一个参数固定是
$query，代表当前查询对象 - 返回值无需
return $query（TP 内部自动处理），但也不能返回数组或字符串 - 如果用了
return，且返回非$query，链式会中断，后续->select()报错
scope传参只有两种合法形式
想传参数给 scopeHot，不能靠猜——ThinkPHP 只认两种调用方式，其他都丢参数或报 Warning。
-
User::scope('hot', 30)→ 第二个参数直接传给scopeHot的第二个形参，即$min = 30 -
User::scope(['hot' => 30])→ 要求方法签名必须接收关联数组：scopeHot($query, $params = [])，再取$params['hot'] - 误写成
->scope('hot', ['days' => 30])或->scope(['hot' => 30, 'top' => true])却没改方法签名，PHP 会发 Warning，但$min拿不到值，条件按默认值走
多个scope组合时顺序影响SQL逻辑
User::scope('hot')->scope('latest')->select() 和 User::scope('latest')->scope('hot')->select() 生成的 SQL 不一定等价——因为每个 scope 都是在当前 $query 上追加条件，而 where 和 order 的叠加顺序会影响最终执行逻辑。
立即学习“PHP免费学习笔记（深入）”；
-
scopeHot加where('created_at', '>=', ...)，scopeLatest加order('created_at', 'desc')：顺序无关 - 但若
scopeTop($query, $n)写成$query->limit($n)->order('score', 'desc')，放在scopePublished前后，可能查出不同记录（limit 在 order 前会截断未排序数据） - 建议把
order、limit类操作尽量放链尾，或统一用闭包封装复杂逻辑
scope里不能调用select/find，也不能写原生SQL拼接
scope 的唯一职责是“修改查询对象”，不是“执行查询”。一旦在 scope 方法里写了 $query->select() 或 Db::table(...)->where(...)->select()，会导致链式中断、返回结果类型错乱，甚至报 Call to a member function where() on array。
- 错误示例：
$query->where(...)->select()—— 这里select()返回数组，后续链式调用就崩了 - 也别在 scope 里用
Db::raw("title LIKE '%{$keyword}%')"直接拼字符串，容易 SQL 注入；要用$query->where('title', 'like', "%{$keyword}%")让 TP 自动参数绑定 - 需要动态字段或复杂 OR 条件？用闭包代替 scope：
User::scope(function ($q) use ($words) { foreach ($words as $w) $q->whereOr('title', 'like', "%$w%"); })->select()
最容易被忽略的是：scope 方法名大小写必须和调用时完全一致，scopePublished 不能用 ->scope('published')（TP 默认转小写匹配，但部分环境区分大小写）；另外，全局作用域 base 方法如果存在，会无感覆盖你的 scope 条件，调试时记得先试 User::withoutGlobalScope()->scope('hot')->select() 排除干扰。
