本文详解 laravel eloquent 中正确筛选“当前时间落在指定时间区间内”的记录的方法，纠正常见链式调用误用，并提供安全、高效、可读性强的实现方案。
本文详解 laravel eloquent 中正确筛选“当前时间落在指定时间区间内”的记录的方法，纠正常见链式调用误用，并提供安全、高效、可读性强的实现方案。
在 Laravel 开发中，一个高频需求是：获取当前时刻（NOW()）处于 publication_start_at 与 publication_end_at 之间（含边界）的公告或内容。但许多开发者会误用 Collection::where() 方法，导致逻辑错误甚至空结果——正如示例代码中所示：
// ❌ 错误写法：对 Collection 调用 where()，且语法完全不合法
$official_message = OfficialMessage::all()
->where($today, '>=', 'publication_start_at', '&&', $today, '<=', 'publication_end_at');该写法存在三重问题：
- OfficialMessage::all() 已将全部数据加载为内存中的 Collection，后续 where() 是对集合的遍历过滤，无法利用数据库索引，性能极差，且不支持字段比较运算符；
- Collection::where() 不接受 '>=', '&&' 等 SQL 运算符，其签名是 where($key, $operator, $value) 或 where($key, $value)，传入 6 个参数会直接报错或静默失败；
- $today 是 PHP 字符串，而数据库字段是 DATETIME 类型，手动拼接易引发时区、格式（如秒精度）、SQL 注入等风险。
✅ 正确做法是：在查询构建器（QueryBuilder）层面使用数据库原生时间函数完成条件判断，让筛选发生在数据库层：
✅ 推荐方案：使用 whereRaw() 结合 NOW()
public function show()
{
$messages = OfficialMessage::whereRaw('NOW() BETWEEN publication_start_at AND publication_end_at')
->orderBy('publication_start_at')
->get();
return view('front.pages.message', [
'messages' => $messages,
]);
}- WHERE NOW() BETWEEN ... AND ... 语义清晰、兼容主流数据库（MySQL/PostgreSQL），且自动处理 NULL 边界（若任一字段为 NULL，整行不匹配，符合业务预期）；
- orderBy() 替代已废弃的 sortBy()，确保排序由数据库执行，效率更高；
- 全程未调用 all()，避免全表加载，符合 Laravel 最佳实践。
? 进阶建议：时区安全 & 可测试性
若应用部署在多时区环境，或需单元测试（避免依赖真实 NOW()），推荐使用 DB::raw() 配合 Carbon：
use Carbon\Carbon;
use Illuminate\Support\Facades\DB;
// 方案二：显式传入当前时间（推荐用于测试/时区控制）
$now = Carbon::now()->toDateTimeString(); // 或 ->utc()->toDateTimeString()
$messages = OfficialMessage::where('publication_start_at', '<=', $now)
->where('publication_end_at', '>=', $now)
->orderBy('publication_start_at')
->get();此方式：
- 明确控制时间基准，规避数据库服务器时区与 PHP 时区不一致问题；
- 支持在测试中注入固定时间点（如 Carbon::setTestNow('2024-01-01 12:00:00')），提升可测性；
- 利用 Eloquent 原生 where()，类型安全，自动转义，杜绝 SQL 注入。
⚠️ 注意事项总结
- 永远避免 Model::all()->where(...)：这是 N+1 和内存爆炸的典型陷阱；
- BETWEEN 是闭区间（包含端点），若需开区间（如仅显示“正在生效中”，不含刚开始/刚结束的瞬间），改用 > 和
- 确保数据库字段 publication_start_at 和 publication_end_at 类型为 DATETIME 或 TIMESTAMP，并建立联合索引提升查询性能：
ALTER TABLE official_messages ADD INDEX idx_pub_range (publication_start_at, publication_end_at);
- 若存在大量历史数据，考虑添加软删除（deleted_at）或状态字段（status），避免无效数据干扰范围查询。
掌握这一模式，你不仅能精准获取“当前有效”的动态内容，更能写出高性能、可维护、可测试的 Laravel 时间范围查询逻辑。
