Laravel Eloquent：高效统计与多条件时间范围查询指南-php教程-PHP中文网

Laravel Eloquent：高效统计与多条件时间范围查询指南

心靈之曲

发布： 2025-10-23 08:23:00

原创

483人浏览过

Laravel Eloquent：高效统计与多条件时间范围查询指南

本文详细介绍了如何在 laravel 中使用 eloquent orm 进行多条件数据统计，特别是针对特定用户、特定状态码，并结合时间范围（如当天或最近24小时）进行精确过滤和计数。通过示例代码，阐述了如何构建复杂的 `where` 子句以及如何利用 `count()` 方法获取结果总数，同时提供了优化建议。

在现代Web应用开发中，数据统计和分析是常见的需求。Laravel 的 Eloquent ORM 提供了一套强大而优雅的API，使得开发者能够轻松地构建复杂的数据库查询。本教程将聚焦于如何利用 Eloquent 实现多条件过滤，包括用户ID、状态码以及时间范围（如当天或最近24小时），并最终获取符合条件的记录总数。

核心需求分析

假设我们面临这样一个场景：需要统计某个特定公司（或用户）在过去24小时内，或者在当天，产生了多少条特定状态码（例如400）的Webhook日志。原始查询可能只包含了公司ID的过滤，而忽略了状态码和时间维度的限制，也未能直接获取计数。

// 初始查询，仅过滤了公司ID，并获取了所有匹配的日志
$webhookLog = WebhookLog::where('company_id', $company->id)
    ->orderBy('updated_at', 'desc')
    ->get();

登录后复制

显然，这个查询无法满足我们的全部需求。我们需要添加额外的过滤条件并更改最终的操作。

构建基础过滤条件

首先，我们需要根据 company_id 和 status_code 进行过滤。where 方法是实现这一目标的基石。

use App\Models\WebhookLog;

// 假设 $company->id 是当前公司的ID， $statusCode 是我们关注的状态码，例如 400
$companyId = $company->id;
$statusCode = 400; // 示例：HTTP 400 Bad Request

$query = WebhookLog::where('company_id', $companyId)
                    ->where('status_code', $statusCode);

登录后复制

此时，$query 对象包含了按公司ID和状态码过滤的条件，但尚未执行，也未包含时间过滤。

实现时间范围过滤

根据需求，时间过滤可以分为两种常见情况：“当天”和“最近24小时”。

1. 过滤当天记录

如果需要统计“当天”的记录，我们可以利用 whereBetween 方法结合日期字符串来定义时间范围。

use Carbon\Carbon;

// 获取当前日期字符串，例如 '2023-10-27'
$today = Carbon::today(); // Carbon 实例，代表今天的开始时间
$tomorrow = Carbon::tomorrow(); // Carbon 实例，代表明天的开始时间

$query->whereBetween('updated_at', [$today, $tomorrow]);

登录后复制

或者，如果习惯使用字符串拼接：

$dateString = date('Y-m-d'); // 例如 '2023-10-27'

$query->whereBetween('updated_at', [$dateString . " 00:00:00", $dateString . " 23:59:59"]);

登录后复制

推荐使用 Carbon 实例，它能更好地处理时区问题，并且代码更具可读性。

2. 过滤最近24小时记录

如果需求是统计“最近24小时”内的记录，我们可以使用 now() 方法结合 subDay() 来计算时间点。

美间AI

美间AI：让设计更简单

查看详情

use Carbon\Carbon;

$last24Hours = Carbon::now()->subDay(); // 24小时前的时间点

$query->where('updated_at', '>=', $last24Hours);

登录后复制

这种方法更精确地反映了“最近24小时”的语义，而不是从当天零点开始计算。

获取记录总数

一旦所有的过滤条件都已添加到查询中，我们不再需要获取完整的模型集合，而只需要它们的总数。这时，将 get() 方法替换为 count() 方法即可。

// 假设 $query 已经包含了所有过滤条件
$totalCount = $query->count();

登录后复制

count() 方法会执行一个 SELECT COUNT(*) 类型的SQL查询，效率远高于先 get() 再 count() 集合元素的方式。

综合示例

以下是根据上述分析，结合不同时间范围过滤条件的完整示例代码：

<?php

namespace App\Http\Controllers;

use App\Models\WebhookLog;
use Carbon\Carbon;
use Illuminate\Http\Request;

class WebhookLogController extends Controller
{
    /**
     * 统计指定公司和状态码的Webhook日志。
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  int  $companyId      要查询的公司ID
     * @param  int  $statusCode     要查询的状态码，例如 400
     * @param  string $timeframe    时间范围：'today' 或 'last24h'
     * @return \Illuminate\Http\JsonResponse
     */
    public function countLogs(Request $request, int $companyId, int $statusCode, string $timeframe)
    {
        // 构建基础查询
        $query = WebhookLog::where('company_id', $companyId)
                           ->where('status_code', $statusCode);

        // 根据时间范围添加过滤条件
        switch ($timeframe) {
            case 'today':
                $query->whereBetween('updated_at', [Carbon::today(), Carbon::tomorrow()]);
                break;
            case 'last24h':
                $query->where('updated_at', '>=', Carbon::now()->subDay());
                break;
            default:
                // 如果没有指定有效的时间范围，可以返回错误或默认不进行时间过滤
                return response()->json(['error' => 'Invalid timeframe specified. Use "today" or "last24h".'], 400);
        }

        // 获取符合条件的记录总数
        $totalCount = $query->count();

        return response()->json([
            'company_id' => $companyId,
            'status_code' => $statusCode,
            'timeframe' => $timeframe,
            'log_count' => $totalCount
        ]);
    }
}

登录后复制

注意事项与最佳实践

数据库索引： 为了优化查询性能，确保 webhook_logs 表的 company_id、status_code 和 updated_at 字段都建立了索引。特别是 updated_at 字段上的索引对于时间范围查询至关重要。
时区处理： Laravel 默认使用 UTC 存储数据库时间戳。在使用 Carbon::now()、Carbon::today() 等方法时，请确保你的应用时区配置 (config/app.php 中的 timezone) 与你的业务逻辑相符，或者显式地进行时区转换。例如，Carbon::now()->timezone('Asia/Shanghai')。

可读性与维护性： 对于更复杂的查询逻辑，可以考虑使用 Eloquent Local Scopes 将查询条件封装起来，提高代码的可读性和复用性。

// 在 WebhookLog 模型中定义一个 Scope
class WebhookLog extends Model
{
    public function scopeForCompanyAndStatus($query, $companyId, $statusCode)
    {
        return $query->where('company_id', $companyId)
                     ->where('status_code', $statusCode);
    }

    public function scopeUpdatedToday($query)
    {
        return $query->whereBetween('updated_at', [Carbon::today(), Carbon::tomorrow()]);
    }

    public function scopeUpdatedLast24Hours($query)
    {
        return $query->where('updated_at', '>=', Carbon::now()->subDay());
    }
}

// 使用 Scope
$countToday = WebhookLog::forCompanyAndStatus($companyId, $statusCode)
                        ->updatedToday()
                        ->count();

$countLast24h = WebhookLog::forCompanyAndStatus($companyId, $statusCode)
                          ->updatedLast24Hours()
                          ->count();

登录后复制

总结

通过本教程，我们学习了如何在 Laravel 中利用 Eloquent ORM 高效地进行多条件数据统计。关键在于理解 where 子句的组合使用，掌握 whereBetween 和 Carbon 库进行时间范围过滤的方法，以及最终使用 count() 方法来获取记录总数。结合数据库索引和良好的代码组织，可以构建出既强大又高性能的数据统计功能。

以上就是Laravel Eloquent：高效统计与多条件时间范围查询指南的详细内容，更多请关注php中文网其它相关文章！