Laravel 关系查询中正确组合日期范围与关键词搜索的实践方法-php教程-PHP中文网

Laravel 关系查询中正确组合日期范围与关键词搜索的实践方法

本文详解如何在 Laravel 中正确实现关联模型的日期范围过滤与关键词搜索，避免因 SQL 运算符优先级导致的逻辑错误（如 WHERE date AND ... OR ... 错误匹配），并提供结构清晰、可维护的查询构建方案。

本文详解如何在 laravel 中正确实现关联模型的日期范围过滤与关键词搜索，避免因 sql 运算符优先级导致的逻辑错误（如 `where date and ... or ...` 错误匹配），并提供结构清晰、可维护的查询构建方案。

在 Laravel 中对关联数据执行带日期范围的关键词搜索时，一个常见却极易被忽视的问题是：where() 与 orWhere() 的混合使用会破坏查询逻辑优先级，导致日期过滤失效。正如你在原始代码中所遇到的——即使指定的日期范围内无数据，只要某条记录满足任意一个 orWhere 条件，它仍会被返回。

根本原因在于生成的 SQL 中 AND 与 OR 缺乏分组，等价于：

WHERE (date(rekans.created_at) >= ? AND date(rekans.created_at) <p>这使得日期条件仅约束第一个 LIKE 子句，其余 OR 分支完全绕过时间筛选。</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2156" title="Laravel 13.2.0"><img
														src="https://img.php.cn/upload/manual/001/242/473/69e6e5924a679487.png" alt="Laravel 13.2.0" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/gongju/2156" title="Laravel 13.2.0" class="overflowclass">Laravel 13.2.0</a>
													<p class="overflowclass">PHP中文网提供Laravel 13.2.0版本下载，Laravel框架 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。</p>
												</div>
												<a rel="nofollow" href="/xiazai/gongju/2156" title="Laravel 13.2.0" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div><p>✅ 正确解法是：<strong>将所有搜索条件包裹在闭包中，用 where(...) 统一封装为一个逻辑组</strong>，确保整个搜索块与日期条件以 AND 关系组合：</p><pre class="brush:php;toolbar:false;">$rekans = Rekan::query()
    ->join('dokters', 'dokters.id', '=', 'rekans.dokter_id')
    ->join('pasiens', 'pasiens.id', '=', 'rekans.pasien_id')
    ->join('penyakits', 'penyakits.id', '=', 'rekans.dokter_id') // ⚠️ 注意：此处疑似关联错误（应为 penyakits.id = rekans.penyakit_id？请按实际模型关系校验）
    ->join('treatments', 'treatments.id', '=', 'rekans.treatment_id');

// ✅ 日期范围：独立且明确的 AND 条件
if (request('from_date')) {
    $rekans->whereDate('rekans.created_at', '>=', request('from_date'));
}
if (request('to_date')) {
    $rekans->whereDate('rekans.created_at', 'where(function ($query) use ($searchTerm) {
        $query->where('rekans.berat', 'LIKE', $searchTerm)
              ->orWhere('rekans.rekan_inv', 'LIKE', $searchTerm)
              ->orWhere('rekans.suhu', 'LIKE', $searchTerm)
              ->orWhere('rekans.hasil_pemeriksaan', 'LIKE', $searchTerm)
              ->orWhere('rekans.anamnesa', 'LIKE', $searchTerm)
              ->orWhere('rekans.pengobatan', 'LIKE', $searchTerm)
              ->orWhere('rekans.kasus', 'LIKE', $searchTerm)
              ->orWhere('dokters.nama_dokter', 'LIKE', $searchTerm)
              ->orWhere('pasiens.nama', 'LIKE', $searchTerm)
              ->orWhere('penyakits.nama_penyakit', 'LIKE', $searchTerm)
              ->orWhere('treatments.nama_treatment', 'LIKE', $searchTerm);
    });
}

// 最终执行（建议添加分页与排序）
$results = $rekans->select('rekans.*', 'dokters.nama_dokter', 'pasiens.nama')
                  ->orderBy('rekans.created_at', 'desc')
                  ->paginate(15);

? 关键实践建议：

始终为多 OR 条件加 where(function () {}) 包裹，这是 Laravel 查询构造器的黄金准则；
显式限定字段前缀（如 'rekans.berat'），避免因 JOIN 表存在同名字段引发歧义或报错；
验证关联逻辑：你当前 penyakits.id = rekans.dokter_id 很可能有误（疾病通常不通过医生 ID 关联），请核对数据库设计与 Eloquent 关系定义；
安全增强：对 request('search') 做非空与长度校验，防止空字符串触发全表模糊扫描；
性能提示：在 rekans.created_at、常用于搜索的字段（如 rekan_inv）上建立复合索引可显著提升查询效率。

遵循以上写法，当日期范围（如 2022-04-13 至 2022-04-14）内无匹配数据时，查询将严格返回空集合，完全符合业务预期。