Laravel Eloquent 查询技巧：高效统计指定条件下的日志记录-php教程-PHP中文网

Laravel Eloquent 查询技巧：高效统计指定条件下的日志记录

花韻仙語

发布： 2025-10-24 11:59:32

原创

818人浏览过

Laravel Eloquent 查询技巧：高效统计指定条件下的日志记录

本文详细阐述了如何利用 laravel eloquent 查询构建器，高效地统计特定用户在指定时间范围（如过去24小时或今日）内，并且符合特定状态码的日志记录数量。通过链式调用 `where` 方法进行多条件过滤，并最终使用 `count()` 方法获取结果，帮助开发者精确掌握数据概览。

在 Laravel 应用开发中，我们经常需要对数据进行复杂的筛选和统计。例如，统计某个特定公司在过去24小时内，且状态码为400的请求日志数量。这需要我们灵活运用 Eloquent 的查询构建器来实现多条件过滤和计数。

Eloquent 查询构建器核心概念

Laravel 的 Eloquent ORM 提供了一个直观且强大的查询构建器，允许开发者以面向对象的方式与数据库交互。实现复杂统计通常涉及以下关键方法：

where($column, $operator, $value): 用于添加基本的条件过滤。例如 where('company_id', $company-youjiankuohaophpcnid)。
whereBetween($column, array $values): 用于筛选某个字段值在一个指定范围内的记录。常用于日期或数字范围。
where('column', '>=', $value) / where('column', '<=', $value): 结合比较运算符进行日期或数字的范围过滤。
count(): 执行查询并返回符合条件的记录数量，而不是返回实际的记录集合。

精确统计日志记录

针对“统计特定公司在过去24小时内，且状态码为400的日志数量”这一需求，我们需要组合上述方法。

1. 基础过滤：公司ID与状态码

首先，我们需要根据 company_id 和 status_code 进行初步筛选。

use App\Models\WebhookLog; // 假设您的日志模型名为 WebhookLog

$companyId = $company->id; // 从当前上下文获取公司ID
$statusCode = 400; // 示例状态码

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

登录后复制

2. 时间范围过滤

根据需求，时间范围的定义有两种常见方式：“过去24小时”和“今日日志”。

a. 统计过去24小时内的日志

“过去24小时”是指从当前时间点回溯24小时。这可以通过 Carbon 库（Laravel 内置）的 now()->subDay() 方法来实现。

巧文书

巧文书是一款AI写标书、AI写方案的产品。通过自研的先进AI大模型，精准解析招标文件，智能生成投标内容。

查看详情

use Carbon\Carbon;

$query->where('updated_at', '>=', Carbon::now()->subDay());

登录后复制

b. 统计今日日志

“今日日志”通常指从当天00:00:00到当前时间的所有日志。这可以使用 whereBetween 结合 Carbon::today()->startOfDay() 和 Carbon::now() 来实现。

use Carbon\Carbon;

// 如果需要统计今日日志，可以这样修改
// $query->whereBetween('updated_at', [Carbon::today()->startOfDay(), Carbon::now()]);

登录后复制

请注意，Carbon::today()->startOfDay() 等同于 Carbon::now()->startOfDay()。

3. 获取计数

最后，将 get() 方法替换为 count() 即可获取符合所有条件的记录数量。

实战示例

以下是一个完整的控制器方法示例，演示如何统计特定公司在过去24小时内，状态码为400的日志数量：

<?php

namespace App\Http\Controllers;

use App\Models\WebhookLog;
use Illuminate\Http\Request;
use Carbon\Carbon; // 确保引入 Carbon

class LogController extends Controller
{
    /**
     * 统计指定公司在过去24小时内，特定状态码的Webhook日志数量。
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function countRecentWebhookLogs(Request $request)
    {
        // 假设公司ID和状态码从请求中获取，或者从业务逻辑中确定
        // 为简化示例，这里直接赋值
        $companyId = 1; // 示例公司ID
        $statusCode = 400; // 示例状态码，如 HTTP 400 Bad Request

        // 构建查询
        $logCount = WebhookLog::where('company_id', $companyId)
                              ->where('status_code', $statusCode)
                              ->where('updated_at', '>=', Carbon::now()->subDay()) // 过去24小时
                              ->count();

        return response()->json([
            'company_id' => $companyId,
            'status_code' => $statusCode,
            'time_range' => 'last 24 hours',
            'log_count' => $logCount,
            'message' => "Successfully counted logs for company ID {$companyId} with status code {$statusCode} in the last 24 hours."
        ]);
    }

    /**
     * 统计指定公司今日特定状态码的Webhook日志数量。
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function countTodayWebhookLogs(Request $request)
    {
        $companyId = 1; // 示例公司ID
        $statusCode = 400; // 示例状态码

        $logCount = WebhookLog::where('company_id', $companyId)
                              ->where('status_code', $statusCode)
                              ->whereBetween('updated_at', [Carbon::today()->startOfDay(), Carbon::now()]) // 今日日志
                              ->count();

        return response()->json([
            'company_id' => $companyId,
            'status_code' => $statusCode,
            'time_range' => 'today',
            'log_count' => $logCount,
            'message' => "Successfully counted logs for company ID {$companyId} with status code {$statusCode} today."
        ]);
    }
}

登录后复制

注意事项

时间范围的精确性：务必根据业务需求选择正确的日期时间过滤方法。“过去24小时”和“今日”是两个不同的概念，选择不当可能导致数据不准确。
数据库索引：为了提高查询性能，建议为 company_id、status_code 和 updated_at 这些常用作查询条件的列添加数据库索引。
链式调用：Eloquent 查询构建器支持链式调用，使代码更加简洁易读。每个 where 方法都会返回查询构建器实例，允许继续添加其他条件。
模型引用：确保在控制器或服务中正确引入了对应的 Eloquent 模型（例如 use App\Models\WebhookLog;）。
Carbon 库：Carbon 是 PHP 的日期时间 API 扩展，在 Laravel 中广泛使用。熟练掌握其日期操作方法对于处理时间相关查询至关重要。