正如文章摘要所述，本文将介绍在 Laravel 框架下，如何根据前端传递的可选日期参数，构建灵活的数据库查询，筛选出指定日期范围内的数据。文章将通过示例代码，展示如何使用 when() 方法简化条件判断，避免冗余的 if-else 结构，从而实现更简洁、高效的日期范围过滤功能。同时，也会强调在处理日期查询时，性能和逻辑清晰的重要性。
在实际开发中，经常会遇到需要根据用户选择的日期范围进行数据筛选的需求。然而，用户可能只选择起始日期、只选择结束日期，或者同时选择起始和结束日期，甚至不选择任何日期。针对这些情况，我们需要构建一个灵活的查询，能够根据实际传入的参数进行相应的过滤。
传统的做法是使用大量的 if-else 语句来判断日期参数是否为空，然后构建不同的查询条件。这种方式代码冗余，可读性差，维护成本高。Laravel 提供了 when() 方法，可以优雅地解决这个问题。
when() 方法接受两个参数：第一个参数是一个条件，第二个参数是一个闭包。当条件为真时，闭包会被执行，闭包内可以定义额外的查询条件。
以下是一个使用 when() 方法实现可选日期范围查询的示例：
use App\Models\AnalyticsOrder;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;
public function getAnalyticsData(Request $request)
{
$startDate = $request->input('start-date');
$endDate = $request->input('end-date');
$workgroupId = $request->input('workgroup-id');
$user = Auth::user(); // 获取当前用户
$workgroups = AnalyticsOrder::where('workgroup_id', $workgroupId)
->whereHas('workgroup', function ($query) use ($user) {
$query->where('user_id', $user->id);
})
->when($startDate, function ($query) use ($startDate) {
$query->where('created_at', '>=', $startDate);
})
->when($endDate, function ($query) use ($endDate) {
$query->where('created_at', '<=', $endDate);
})
->get();
return response()->json($workgroups);
}代码解释：
- 首先，从请求中获取 start-date 和 end-date 参数。
- 使用 AnalyticsOrder::where('workgroup_id', $workgroupId) 开始构建查询。
- 使用 whereHas('workgroup', function ($query) use ($user) { ... }) 确保只有属于当前用户的 workgroup 才能被查询到。
- ->when($startDate, function ($query) use ($startDate) { ... })：如果 start-date 不为空，则添加 created_at >= $startDate 的条件。
- ->when($endDate, function ($query) use ($endDate) { ... })：如果 end-date 不为空，则添加 created_at <= $endDate 的条件。
- 最后，使用 ->get() 执行查询，并返回结果。
注意事项：
- 日期格式： 确保前端传递的日期格式与数据库中 created_at 字段的日期格式一致。如果不一致，需要进行转换。可以使用 Carbon 类进行日期格式化。
- 时区问题： 注意时区问题。如果前端和后端使用的时区不一致，可能会导致日期范围查询结果不正确。建议在应用程序中统一使用 UTC 时区。
- 性能优化： 对于大数据量的表，建议在 created_at 字段上创建索引，以提高查询效率。
- 安全性： 对用户输入的日期参数进行验证，防止 SQL 注入攻击。
总结：
使用 Laravel 的 when() 方法可以简化条件查询的逻辑，使代码更简洁、易读、易维护。在处理可选日期范围查询时，when() 方法是一个非常有用的工具。同时，需要注意日期格式、时区问题和安全性，以确保查询结果的正确性和安全性。
