
本文介绍如何在 Laravel 中将数据库中按 triwulan(季度)和 bulan(月份)字段组织的数据,在 Blade 模板中通过嵌套 @foreach 清晰渲染为“季度标题 + 对应月份列表”的结构。
本文介绍如何在 laravel 中将数据库中按 `triwulan`(季度)和 `bulan`(月份)字段组织的数据,在 blade 模板中通过嵌套 `@foreach` 清晰渲染为“季度标题 + 对应月份列表”的结构。
在 Laravel 开发中,当需要将平铺的数据(如每条记录含 triwulan 和 bulan 字段)按逻辑分组展示时,直接在 Blade 中硬编码判断会破坏可维护性。推荐做法是在控制器中预先完成数据结构化处理,再交由视图专注渲染。
首先,在控制器中使用 Laravel 集合(Collection)的 mapToGroups() 方法对查询结果进行分组:
public function index()
{
$dth = DTH::all();
// 按 triwulan 字段分组,每个季度对应一个包含多条记录的子集合
$groupedQuarterly = $dth->mapToGroups(function ($item) {
return [$item->triwulan => $item];
})->sortByKey(); // 可选:按季度数字升序排列(1, 2, 3, 4)
return view('Triwulan.index', compact('groupedQuarterly'));
}
✅ 注意:$item->triwulan 是模型属性访问方式(非数组下标 $item['triwulan']),前提是模型未禁用属性访问或启用了 $casts/$appends 等影响行为的配置;若字段名含特殊字符或需兼容严格模式,可改用 $item->getAttribute('triwulan')。
接着,在 resources/views/Triwulan/index.blade.php 中使用双重 @foreach 进行嵌套渲染:
<div class="card mb-4">
@foreach($groupedQuarterly as $quarterNumber => $quarterRecords)
<h5>Quarter {{ $quarterNumber }}</h5>
<ul>
@foreach($quarterRecords as $record)
<li>{{ ucfirst($record->bulan) }}</li>
@endforeach
</ul>
@endforeach
</div>
? 关键说明与最佳实践:
- mapToGroups() 返回的是 Illuminate\Support\Collection 类型,其键为 triwulan 值(如 "1"、"4"),值为该季度下所有模型实例组成的子集合;
- Blade 中 $quarterRecords 是集合对象,支持直接 @foreach 遍历,无需调用 ->toArray()(除非你明确需要数组索引);
- 使用 ucfirst() 统一月份首字母大写(如 "oktober" → "Oktober"),提升显示一致性;
- 若数据库中 bulan 存储的是英文缩写(如 "Jan")或不规范拼写,建议在模型中添加访问器(accessor)做标准化映射,例如:
// 在 App\Models\DTH 中
protected $appends = ['formatted_bulan'];
public function getFormattedBulanAttribute()
{
$mapping = [
'jan' => 'January', 'feb' => 'February', 'mar' => 'March',
'apr' => 'April', 'mei' => 'May', 'jun' => 'June',
'jul' => 'July', 'ags' => 'August', 'sep' => 'September',
'okt' => 'October', 'nov' => 'November', 'des' => 'December',
];
return $mapping[strtolower($this->attributes['bulan'] ?? '')] ?? $this->bulan;
}
然后视图中可改为 {{ $record->formatted_bulan }},进一步解耦业务逻辑与展示层。
最后提醒:若数据量较大(如千级记录),建议在数据库层完成分组(如使用 groupBy('triwulan') + withCount() 或原生 SQL),避免全量加载后 PHP 内存处理。但对于常规报表类场景,本方案简洁高效、符合 Laravel 惯例,是推荐的入门级解决方案。











