PHPEloquent查询年度数据方法

本文深入剖析了在 Laravel Eloquent 中高效、安全查询年度数据的最佳实践，重点强调必须使用内置的 `whereYear()` 方法替代手写 `whereRaw('YEAR(created_at) = ?')`，以规避索引失效、跨数据库兼容性崩溃（如 PostgreSQL 不支持 YEAR()）、SQL 注入风险及 MySQL 8.0+ 兼容问题；同时指出性能优化的关键在于理解业务本质——若追求查询速度，应优先采用 `whereBetween()` 配合日期范围（充分利用 B-tree 索引），而非依赖年份函数过滤；文章还厘清了 `whereYear()` 与分组统计的职责边界，并给出跨库安全的分组方案和索引建设建议，直击线上慢查询的常见根源。

直接用 whereYear()，别手写 WHERE YEAR(created_at) = ? —— 否则索引失效、查询变慢、MySQL 8.0+ 还可能报错。

为什么不能用 whereRaw('YEAR(created_at) = ?')

看似能跑通，但实际埋了三个坑：

• MySQL 无法使用 created_at 字段上的 B-tree 索引，全表扫描成常态
• PostgreSQL 不支持 YEAR() 函数，换数据库就崩
• Laravel 9+ 在 strict 模式下对 whereRaw 中的函数调用更敏感，容易触发 SQL injection 警告（尤其参数没绑定时）

whereYear() 的正确用法和参数细节

它底层会根据数据库类型自动翻译成兼容写法：YEAR(col) = ?（MySQL）、EXTRACT(YEAR FROM col) = ?（PostgreSQL）、strftime('%Y', col) = ?（SQLite）。

基本写法：

$orders = Order::whereYear('created_at', 2023)->get();

支持变量和比较操作：

• 传字符串年份也行：whereYear('created_at', '2023')
• 查范围用闭包：whereYear('created_at', '>=', 2022)
• 组合多个条件：whereYear('created_at', 2023)->where('status', 'shipped')

需要按年分组汇总？别只靠 whereYear()

whereYear() 是过滤，不是分组。要统计每年订单数，得配合 groupBy() 和 selectRaw()：

$yearlyStats = Order::selectRaw('YEAR(created_at) as year, COUNT(*) as count')
    ->groupBy('year')
    ->orderBy('year')
    ->get();

注意点：

• MySQL 下可用 YEAR(created_at)；PostgreSQL 必须写 EXTRACT(YEAR FROM created_at)，Laravel 不自动转换这个表达式 —— 所以跨库项目建议统一用 selectRaw("EXTRACT(YEAR FROM created_at) as year") 并手动适配
• 如果字段允许 NULL，YEAR(NULL) 返回 NULL，会导致该行被排除在分组外，需确认业务是否要包含未设置时间的数据

日期字段没索引？whereYear() 也救不了性能

哪怕语法全对，如果 created_at 没建索引，或者建的是普通单列索引（非前缀/函数索引），查询照样慢。

MySQL 5.7+ 推荐加函数索引（需开启 innodb_large_prefix）：

ALTER TABLE orders ADD INDEX idx_created_year ((YEAR(created_at)));

但更通用稳妥的做法是：在应用层生成年份范围，用 whereBetween() 配合日期边界：

$start = '2023-01-01';
$end   = '2023-12-31 23:59:59';
Order::whereBetween('created_at', [$start, $end])->get();

这样能走 created_at 的普通 B-tree 索引，兼容所有版本 MySQL/PG/SQLite，且 Laravel 自动处理时区转换。

真正麻烦的不是写哪行代码，而是想清楚：你要的是「精确年份过滤」还是「可索引的范围查询」——前者图省事，后者保性能。很多线上慢查询，就卡在这一步没选对。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。