Laravel Eloquent：高效统计与过滤指定时间段及条件的日志数据-php教程-PHP中文网

Laravel Eloquent：高效统计与过滤指定时间段及条件的日志数据

花韻仙語

发布： 2025-10-23 11:19:14

原创

512人浏览过

Laravel Eloquent：高效统计与过滤指定时间段及条件的日志数据

本文详细介绍了如何在laravel应用中使用eloquent orm对日志数据进行高效的统计和过滤。教程涵盖了如何结合时间范围（如过去24小时或特定日期）和特定条件（如公司id、状态码）来查询并获取符合条件的记录数量，并提供了使用carbon库优化日期处理的专业实践。

在Laravel开发中，经常需要对数据库中的记录进行复杂的查询、过滤和统计。例如，统计特定用户在特定时间段内，且满足某种状态码的日志数量。本教程将以一个Webhook日志为例，详细讲解如何使用Laravel Eloquent ORM实现这一需求。

理解基本查询与过滤

首先，我们来看一个基础的Eloquent查询，它用于获取某个公司所有的Webhook日志，并按更新时间倒序排列：

use App\Models\WebhookLog;

$companyId = $company->id; // 假设 $company 是已获取的公司实例

$webhookLogs = WebhookLog::where('company_id', $companyId)
                          ->orderBy('updated_at', 'desc')
                          ->get();

登录后复制

这个查询能够获取指定公司的所有日志，但它并未包含时间范围和状态码的过滤，也未进行计数。要实现更精细的控制，我们需要引入额外的条件。

添加时间范围过滤

需求中提到要统计“过去24小时”或“特定日期”的日志。Laravel的Carbon库与Eloquent结合，可以非常方便地处理日期和时间。

1. 过滤过去24小时的日志

要获取过去24小时内的日志，可以使用where子句结合now()和subDay()方法：

use App\Models\WebhookLog;
use Carbon\Carbon;

$companyId = $company->id;

$logsLast24Hours = WebhookLog::where('company_id', $companyId)
                             ->where('updated_at', '>=', Carbon::now()->subDay())
                             ->get();

登录后复制

这里，Carbon::now()-youjiankuohaophpcnsubDay() 会生成当前时间减去一天的Carbon实例，where('updated_at', '>=', ...) 则确保只选择更新时间在此之后的记录。

2. 过滤特定日期的日志

如果需要过滤特定一天的日志（例如“今天”的日志），可以使用whereBetween方法，结合today()->startOfDay()和today()->endOfDay()：

美间AI

美间AI：让设计更简单

查看详情

use App\Models\WebhookLog;
use Carbon\Carbon;

$companyId = $company->id;

// 获取今天的日志
$logsToday = WebhookLog::where('company_id', $companyId)
                       ->whereBetween('updated_at', [Carbon::today()->startOfDay(), Carbon::today()->endOfDay()])
                       ->get();

// 或者，如果想指定某个日期，例如 '2023-10-26'
$specificDate = '2023-10-26';
$logsOnSpecificDate = WebhookLog::where('company_id', $companyId)
                                 ->whereBetween('updated_at', [Carbon::parse($specificDate)->startOfDay(), Carbon::parse($specificDate)->endOfDay()])
                                 ->get();

登录后复制

Carbon::today()->startOfDay() 返回今天的零点（如 2023-10-26 00:00:00），Carbon::today()->endOfDay() 返回今天的最后一秒（如 2023-10-26 23:59:59）。whereBetween 方法则用于筛选位于这两个时间点之间的记录。

添加状态码过滤

除了时间过滤，我们还需要根据特定的status_code进行过滤。这只需再添加一个where子句即可：

use App\Models\WebhookLog;
use Carbon\Carbon;

$companyId = $company->id;
$statusCode = 400; // 示例状态码

// 过滤过去24小时内，且状态码为400的日志
$filteredLogs = WebhookLog::where('company_id', $companyId)
                          ->where('updated_at', '>=', Carbon::now()->subDay())
                          ->where('status_code', $statusCode)
                          ->get();

登录后复制

统计符合条件的记录数量

一旦所有的过滤条件都已添加，如果我们的目标是获取符合条件的记录数量而不是实际的记录集合，只需将get()方法替换为count()方法。

完整的教程示例代码

结合上述所有需求，以下是一个完整的Eloquent查询示例，用于统计特定公司在过去24小时内，且状态码为400的Webhook日志数量：

<?php

namespace App\Http\Controllers;

use App\Models\WebhookLog;
use App\Models\Company; // 假设有Company模型
use Carbon\Carbon;
use Illuminate\Http\Request;

class WebhookLogController extends Controller
{
    /**
     * 统计特定公司在过去24小时内，特定状态码的Webhook日志数量。
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \App\Models\Company  $company
     * @return \Illuminate\Http\JsonResponse
     */
    public function countFilteredLogs(Request $request, Company $company)
    {
        // 定义要过滤的状态码，例如 400
        $statusCode = 400;

        // 构建查询
        $logCount = WebhookLog::where('company_id', $company->id)
                              ->where('updated_at', '>=', Carbon::now()->subDay()) // 过去24小时
                              // ->whereBetween('updated_at', [Carbon::today()->startOfDay(), Carbon::today()->endOfDay()]) // 如果是今天
                              ->where('status_code', $statusCode)
                              ->count(); // 获取计数

        return response()->json([
            'company_id' => $company->id,
            'status_code' => $statusCode,
            'time_frame' => 'last_24_hours',
            'log_count' => $logCount,
        ]);
    }
}

登录后复制

注意事项与最佳实践

使用Carbon进行日期处理： 始终推荐使用Laravel内置的Carbon库来处理日期和时间，它提供了丰富的API，使日期操作变得简单和直观。
链式调用： Eloquent的查询构建器支持链式调用，使代码更具可读性和简洁性。
索引优化： 对于经常用于where子句的字段（如company_id, updated_at, status_code），确保在数据库表中创建索引，这将显著提高查询性能，尤其是在数据量较大时。
动态条件： 在实际应用中，statusCode或时间范围可能来自用户输入。确保对这些输入进行验证和清理，以防止SQL注入等安全问题。
选择正确的时间范围： “过去24小时”和“今天”是不同的概念。根据实际需求选择Carbon::now()->subDay()或Carbon::today()->startOfDay()/endOfDay()。