laravel 中自定义局部作用域（如 `scopelatest`）若与 eloquent 内置方法（如 `latest()`）同名，将被优先调用内置方法，导致作用域完全失效——这是常见但易被忽略的命名陷阱。
在 Laravel 的 Eloquent ORM 中，局部作用域（Local Scopes）是通过在模型中定义以 scope 开头的公共方法来实现的，例如 scopePopular() 或 scopeActive()。这些方法会被自动识别并支持链式调用，前提是方法名不与 Eloquent 查询构建器（Illuminate\Database\Eloquent\Builder）中已存在的公共方法冲突。
你遇到的问题根源正在于此：你定义了名为 scopeLatest 的作用域，但 Eloquent 已内置了一个同名的 latest() 方法（用于按时间字段倒序排序，默认为 created_at）。当执行 Test::latest(3)->get() 时，PHP 直接调用了 Builder::latest($column) 方法（该方法仅接受一个可选列名参数，不接受 $limit），而完全跳过了你的自定义作用域——因为 latest 是一个公开、可直接访问的方法，PHP 不会触发 __call() 魔术方法去查找作用域。
✅ 正确做法：为作用域选择唯一、非保留的名称。推荐使用语义清晰且带业务前缀的命名，例如：
// ✅ 推荐：避免冲突，语义明确
public function scopeLatestAvailable($query, int $limit)
{
return $query
->select(['id', 'title', 'main_photo', 'area', 'price', 'city', 'short_desc'])
->whereIn('status', ['Dostepne', 'Zarezerwowane'])
->orderBy('id', 'desc')
->limit($limit);
}然后在控制器中调用：
$flats = Test::latestAvailable(3)->get();
⚠️ 注意事项：
- Laravel 内置的 latest() 和 oldest() 方法不接收数字参数；传入 3 会被忽略，实际行为等价于 ->latest()->limit(3) —— 但因作用域未生效，limit(3) 也未执行，最终返回全表数据。
- 若坚持使用 latest 语义，可改用全局作用域（Global Scope）或在查询中显式组合：Test::whereIN(...)->orderBy(...)->limit(3)->get()。
- 所有作用域方法的第一个参数必须是 $query（类型提示可为 Builder，但需引入命名空间：use Illuminate\Database\Eloquent\Builder;）。
? 总结：Eloquent 作用域机制依赖 __call() 的兜底逻辑，仅当调用的方法在 Builder 上不存在或不可访问时才会尝试匹配 scopeXxx。因此，*永远不要将局部作用域命名为 latest、oldest、withTrashed、onlyTrashed、`where` 等任何 Builder 已声明的公共方法名**。命名即契约——清晰、唯一、无歧义，是可靠作用域设计的第一步。
