0

0

Laravel模型计数?记录数怎样统计获取?

煙雲

煙雲

发布时间:2025-09-06 09:09:03

|

510人浏览过

|

来源于php中文网

原创

使用count()方法高效统计Laravel模型记录数,可结合查询约束、关联关系withCount()、条件筛选及缓存优化,避免内存溢出并提升性能。

laravel模型计数?记录数怎样统计获取?

在Laravel中,要统计模型记录的数量,最直接且推荐的方式是使用查询构建器或Eloquent模型实例上的

count()
方法。它会直接向数据库发送一个
SELECT COUNT(*)
查询,高效地返回符合条件的记录总数,而不是先加载所有数据到内存。

解决方案

统计Laravel模型记录数的核心在于利用框架提供的

count()
方法。这个方法非常灵活,可以应用于多种场景:

  1. 统计整个模型的所有记录: 这是最基础的用法,如果你想知道一个表里总共有多少条数据,直接在模型上调用

    count()
    就可以了。

    use App\Models\User;
    
    $totalUsers = User::count();
    // 假设 User 表有 100 条记录,则 $totalUsers 为 100

    这会生成一个类似

    SELECT COUNT(*) FROM users
    的SQL查询。

  2. 统计满足特定条件的记录:

    count()
    之前,你可以链式调用各种查询约束(如
    where()
    orWhere()
    whereIn()
    等),来精确筛选你需要计数的记录。

    use App\Models\Post;
    
    // 统计所有已发布的文章数量
    $publishedPosts = Post::where('status', 'published')->count();
    
    // 统计标题包含“Laravel”且发布时间在最近一周内的文章数量
    $recentLaravelPosts = Post::where('title', 'like', '%Laravel%')
                                ->where('created_at', '>', now()->subWeek())
                                ->count();

    我个人觉得这种链式调用非常直观,几乎和我们用自然语言思考查询条件一样。

  3. 统计关联模型的记录数: 当你有一个模型实例,并想统计其关联模型的数量时,可以直接在关联关系上调用

    count()

    use App\Models\User;
    use App\Models\Comment;
    
    $user = User::find(1); // 假设我们找到了 ID 为 1 的用户
    if ($user) {
        // 统计该用户发表的评论数量
        $userCommentsCount = $user->comments()->count();
    }
    
    // 或者,如果你想统计所有文章中评论数量大于 5 的文章
    $postsWithManyComments = Post::has('comments', '>=', 5)->count();

    注意

    comments()
    是返回一个查询构建器,所以可以直接在其上调用
    count()

  4. distinct()
    计数: 如果你想统计某个字段的唯一值数量,可以结合
    distinct()
    方法。

    use App\Models\Order;
    
    // 统计有多少个不同的客户下了订单
    $distinctCustomers = Order::distinct('customer_id')->count();
    // 或者
    $distinctCustomers = Order::select('customer_id')->distinct()->count();

    这在分析用户行为或数据分布时非常有用。

理解

count()
的工作原理很重要:它是一个数据库聚合操作,而不是先取出所有数据再在PHP内存中计数。这意味着它通常非常高效,尤其是在处理大量数据时。避免写成
Post::all()->count()
Post::get()->count()
,除非你确实需要先加载所有数据(这在绝大多数计数场景下都是不必要的性能浪费)。

Laravel如何高效统计大量数据模型记录?

在处理大量数据时,统计记录数是一个常见的性能瓶颈点。我的经验告诉我,如果不注意,一个简单的计数操作也可能拖垮应用。要高效地统计Laravel中的大量数据模型记录,有几个核心策略:

首先,始终优先使用

Query Builder
Eloquent
模型上的
count()
方法
。正如前面提到的,
User::count()
这样的调用会直接转化为
SELECT COUNT(*)
类型的SQL查询。数据库系统在执行这种聚合查询时,通常会非常高效,因为它不需要读取实际的行数据,只需遍历索引或表的元数据就能得出结果。这与你想象的“遍历每一条记录再加1”完全不同。

其次,避免不必要的

get()
all()
操作
。这是我见过的最常见的性能陷阱之一。很多人习惯性地写
User::get()->count()
。如果你的
users
表有几十万甚至上百万条记录,
get()
会尝试将所有这些记录加载到PHP内存中,这不仅会消耗巨大的内存,还会因为网络传输和数据序列化/反序列化带来巨大的时间开销。
count()
方法的优势就在于它直接在数据库层面完成计算,只返回一个数字结果。

再者,考虑使用数据库原生查询进行极端优化。虽然Eloquent的

count()
已经很好了,但在某些极其特殊的场景下,比如你需要绕过Eloquent的全局作用域(Global Scopes)或者只是想获取一个裸表的行数,直接使用
DB::table()
可能会稍微快一点点,因为它省去了模型实例化的开销。

use Illuminate\Support\Facades\DB;

// 统计裸表行数,不经过Eloquent模型
$rawCount = DB::table('users')->count();

当然,这通常是微优化,对于绝大多数情况,Eloquent的

User::count()
已经足够。

最后,利用缓存。如果你的记录数变化不频繁,或者对实时性要求不高,将计数结果缓存起来是一个非常有效的策略。你可以设置一个合理的缓存过期时间,比如每隔5分钟更新一次总数。

use Illuminate\Support\Facades\Cache;
use App\Models\User;

$totalUsers = Cache::remember('total_users_count', 300, function () {
    return User::count();
});
// 这里的 300 表示缓存 300 秒(5分钟)

这能显著减少数据库负载,特别是对于那些高频访问的计数展示。我通常会在后台任务或事件监听器中更新这些缓存值,以确保数据的一致性。

Laravel中统计不同条件下的模型记录数有哪些技巧?

统计带条件的记录数是日常开发中的高频需求。Laravel提供了非常灵活的查询构建器,让你可以组合各种条件来精确计数。这里我分享一些我常用的技巧:

WeWedding婚纱影楼小程序
WeWedding婚纱影楼小程序

婚纱影楼小程序提供了一个连接用户与影楼的平台,相当于影楼在微信的官网。它能帮助影楼展示拍摄实力,记录访客数据,宣传优惠活动。使用频率高,方便传播,是影楼在微信端宣传营销的得力助手。功能特点:样片页是影楼展示优秀摄影样片提供给用户欣赏并且吸引客户的。套系页是影楼根据市场需求推出的不同套餐,用户可以按照自己的喜好预定套系。个人中心可以查看用户预约的拍摄计划,也可以获取到影楼的联系方式。

下载
  1. 基础的

    where()
    条件组合: 这是最基本的用法,你可以链式调用多个
    where()
    来实现 AND 逻辑,或者使用
    orWhere()
    来实现 OR 逻辑。

    use App\Models\Order;
    
    // 统计所有已完成且金额大于 100 的订单
    $completedHighValueOrders = Order::where('status', 'completed')
                                    ->where('amount', '>', 100)
                                    ->count();
    
    // 统计状态为“待处理”或“已取消”的订单
    $pendingOrCancelledOrders = Order::where('status', 'pending')
                                    ->orWhere('status', 'cancelled')
                                    ->count();

    对于更复杂的 OR 逻辑,可以使用闭包来分组条件,避免意外的优先级问题:

    // 统计 (状态为“待处理”且金额大于 50) 或 (状态为“已完成”且金额小于 20) 的订单
    $complexOrders = Order::where(function ($query) {
                                $query->where('status', 'pending')
                                      ->where('amount', '>', 50);
                            })
                            ->orWhere(function ($query) {
                                $query->where('status', 'completed')
                                      ->where('amount', '<', 20);
                            })
                            ->count();

    我发现用闭包来组织复杂的

    OR
    语句,代码的可读性会大大提升。

  2. whereIn()
    /
    whereBetween()
    等批量条件:
    当条件值是列表或范围时,这些方法非常方便。

    use App\Models\Product;
    
    // 统计在给定分类 ID 列表中的产品数量
    $categoryIds = [1, 5, 8];
    $productsInCategories = Product::whereIn('category_id', $categoryIds)->count();
    
    // 统计价格在 50 到 200 之间的产品数量
    $productsInPriceRange = Product::whereBetween('price', [50, 200])->count();
  3. whereNull()
    /
    whereNotNull()
    检查空值:

    use App\Models\Task;
    
    // 统计所有未分配负责人的任务
    $unassignedTasks = Task::whereNull('assigned_to_user_id')->count();
  4. 按分组统计 (

    groupBy()
    count()
    结合):
    如果你想知道每个分组有多少条记录,比如每个状态有多少订单,而不是一个总数,
    groupBy()
    就派上用场了。

    use App\Models\Order;
    use Illuminate\Support\Facades\DB;
    
    // 统计每个状态下的订单数量
    $ordersByStatus = Order::select('status', DB::raw('count(*) as total'))
                            ->groupBy('status')
                            ->get();
    /*
    $ordersByStatus 会是一个 Collection,类似:
    [
        { "status": "pending", "total": 50 },
        { "status": "completed", "total": 120 },
        { "status": "cancelled", "total": 15 }
    ]
    */

    这在生成统计报表时非常实用。我经常用它来快速概览不同类别的数据分布。

这些技巧结合起来,几乎可以满足所有基于条件的记录计数需求。关键在于理解查询构建器的链式调用特性,以及如何利用闭包来构建复杂的逻辑。

Laravel模型关联关系中的记录数如何统计?

处理模型关联关系中的记录数统计是一个非常常见的场景,比如统计每篇文章有多少评论,或者每个用户有多少订单。Laravel为此提供了几个非常优雅且高效的方法。

  1. 直接在关联关系上调用

    count()
    如果你已经有一个父模型实例,想知道它有多少个关联子模型,可以直接访问其关联方法并调用
    count()

    use App\Models\Post;
    
    $post = Post::find(1); // 获取 ID 为 1 的文章
    if ($post) {
        // 统计这篇文章有多少条评论
        $commentsCount = $post->comments()->count();
        // 假设 Post 模型有一个 hasMany(Comment::class) 的 comments() 方法
    }

    这种方式很直观,但如果你需要遍历一个集合的父模型并分别获取它们的关联计数,这会导致 N+1 查询问题。

  2. 使用

    withCount()
    避免 N+1 查询: 这是我最推荐的方法,尤其是在你需要获取一个集合的父模型及其关联计数时。
    withCount()
    会在父模型查询时,额外执行一个子查询来获取关联模型的计数,并将结果作为一个新属性添加到每个父模型实例上。

    use App\Models\Post;
    
    // 获取所有文章,并在每篇文章上添加一个 comments_count 属性
    $posts = Post::withCount('comments')->get();
    
    foreach ($posts as $post) {
        echo "文章: " . $post->title . ", 评论数: " . $post->comments_count . "\n";
    }

    withCount()
    的强大之处在于,它只执行两个查询(一个用于父模型,一个用于计数),而不是 N+1 个查询。你可以为
    withCount()
    传递多个关联关系,甚至可以为计数添加条件:

    // 统计每篇文章的评论数和已批准评论数
    $posts = Post::withCount(['comments', 'comments as approved_comments_count' => function ($query) {
        $query->where('is_approved', true);
    }])->get();
    
    foreach ($posts as $post) {
        echo "文章: " . $post->title . ", 总评论数: " . $post->comments_count . ", 已批准评论数: " . $post->approved_comments_count . "\n";
    }

    这简直是统计关联数据时的利器,极大地提升了性能和代码的简洁性。

  3. 基于关联关系进行筛选 (

    has()
    /
    doesntHave()
    /
    whereHas()
    /
    whereDoesntHave()
    ):
    有时你不仅要计数,还要筛选出那些满足特定关联条件的父模型。

    • has('relation')
      筛选出至少有一个关联子模型的父模型。

      use App\Models\Post;
      
      // 统计所有至少有一条评论的文章
      $postsWithComments = Post::has('comments')->count();
      // 也可以指定数量:Post::has('comments', '>=', 5)->count();
    • doesntHave('relation')
      筛选出没有任何关联子模型的父模型。

      // 统计所有没有任何评论的文章
      $postsWithoutComments = Post::doesntHave('comments')->count();
    • whereHas('relation', function($query){ ... })
      筛选出那些关联子模型满足特定条件的父模型。

      // 统计所有拥有至少一条“已批准”评论的文章
      $postsWithApprovedComments = Post::whereHas('comments', function ($query) {
          $query->where('is_approved', true);
      })->count();
    • whereDoesntHave('relation', function($query){ ... })
      whereHas
      相反,筛选出那些关联子模型不满足特定条件的父模型。

      // 统计所有没有任何“未批准”评论的文章 (即所有评论都是已批准的)
      $postsWithoutPendingComments = Post::whereDoesntHave('comments', function ($query) {
          $query->where('is_approved', false);
      })->count();

      这些方法让在复杂的关联场景下进行计数和筛选变得非常灵活和强大。我经常将它们用于构建复杂的仪表盘或数据报告。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

320

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

278

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

373

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

374

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

85

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

65

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

68

2025.08.05

数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

727

2023.10.12

俄罗斯Yandex引擎入口
俄罗斯Yandex引擎入口

2026年俄罗斯Yandex搜索引擎最新入口汇总,涵盖免登录、多语言支持、无广告视频播放及本地化服务等核心功能。阅读专题下面的文章了解更多详细内容。

391

2026.01.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 10万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号