thinkphp 5.1+ 中 scope 方法必须为 public static，仅修改 $query 对象、不 return 不执行查询；带参调用需严格匹配签名；全局作用域需定义 public static base() 并用 useglobalscope(false) 关闭。
scope 方法必须声明为 public static
ThinkPHP 5.1+ 要求所有 scope 方法必须是 public static，否则调用时会静默失败或报 Call to undefined method 错误。旧项目里常见把 scope 写成普通实例方法（public function scopeHot），这在 TP6 中直接不可用。
原因在于：模型类在调用 ->scope('hot') 时，底层是通过静态反射调用该方法，并传入当前查询对象 $query；非静态方法无法被正确绑定上下文。
-
public static function scopeHot($query, $days = 7)✅ 正确 -
public function scopeHot($query)❌ TP5.1+ 不识别，调用无效果 -
protected static function scopeHot($query)❌ 访问权限不足，反射失败
scope 方法体内只能操作 $query，不能 return 或 select()
定义 scope 的唯一职责是“修改查询对象”，不是执行查询。一旦在方法里写了 $query->select() 或 return []，链式就会中断，后续的 ->order()、->with() 全部失效，甚至可能触发 Call to a member function order() on array。
典型错误写法：
public static function scopeTop($query) {
return $query->limit(10)->select(); // ❌ 错！返回的是数组，不是 $query
}
正确写法：
public static function scopeTop($query) {
$query->limit(10); // ✅ 只改 $query，不 return，不 select()
}
- 必须让
$query对象原地修改，不 return 任何值（隐式 return null） - 不能调用
find()、select()、value()等终结方法 - 支持连续调用多个
scope，比如->scope('hot')->scope('top')，顺序即 SQL 中 AND 条件拼接顺序
调用 scope 时参数传递要严格匹配签名
带参 scope 的调用方式和参数顺序必须与方法定义完全一致，否则会报 Missing argument 或静默忽略参数。TP 不做类型推导或默认值兜底，全靠你手动对齐。
例如定义：
public static function scopeEmailLike($query, $keyword, $field = 'email') {
$query->where($field, 'like', "%{$keyword}%");
}
合法调用只有两种：
User::scope('emailLike', 'admin', 'username')->select()-
User::scope('emailLike', 'admin')->select()（使用默认$field = 'email'）
以下写法都会出问题：
-
User::scope('emailLike', ['admin'])→ 把整个数组当第一个参数传入，$keyword变成数组，like条件崩掉 -
User::scope('emailLike', 'admin', 'name', 'extra')→ 多余参数被丢弃，但不会报错，容易埋坑 -
User::scope(['emailLike' => 'admin'])→ 这是旧版 TP5.0 的写法，TP5.1+ 已废弃，不生效
全局作用域 base() 和 useGlobalScope() 的开关逻辑
全局作用域不是靠命名约定，而是靠模型中显式定义的 public static function base($query)。它会在每次查询（包括 get()、find()、select()）前自动注入条件，但仅限于该模型本身。
如果你需要临时绕过全局作用域（比如后台强制查已删除数据），必须显式调用 useGlobalScope(false)：
-
User::useGlobalScope(false)->where('id', 123)->find()✅ 跳过base() -
User::withoutGlobalScope()->find(123)❌ TP6 没这个方法，是 Laravel 写法，混淆易错 -
User::base()->find(123)❌base()是静态方法，不能这样链式调用
注意：base() 方法也必须是 public static，且只接收 $query 一个参数；它不受 scope() 那套规则约束，但同样禁止执行查询操作。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
