本文详解如何在 Laravel Blade 模板中对多层嵌套数据（如球员集合及其连胜记录数组）进行双重 @foreach 遍历，生成扁平化 HTML 表格，并兼顾可读性与性能。
本文详解如何在 laravel blade 模板中对多层嵌套数据（如球员集合及其连胜记录数组）进行双重 `@foreach` 遍历，生成扁平化 html 表格，并兼顾可读性与性能。
在实际开发中，常需将具有层级关系的 JSON 或对象数组渲染为扁平化表格（例如：每位球员对应多条“连胜/连败/平局”记录）。此时需在 Blade 模板中实现外层遍历玩家、内层遍历其 rachasres 子数组的双重循环逻辑。
✅ 正确语法：两层 @foreach 嵌套
假设 $jugadores 是一个包含多个球员对象的数组（Laravel Collection 或原生 PHP 数组），每个球员对象包含属性（如 apodo, nombre）及一个名为 rachasres 的子数组（含多个 streak 对象），则标准 Blade 写法如下：
<table class="s-table">
<thead>
<tr>
<th class="text-center">Jugador</th>
<th class="text-center">Streak</th>
<th class="text-center">Count</th>
<th class="text-center">Start day</th>
<th class="text-center">End day</th>
</tr>
</thead>
<tbody>
@foreach ($jugadores as $jugador)
@foreach ($jugador->rachasres as $racha)
<tr>
<td class="text-center">{{ $jugador->apodo }}</td>
<td class="text-center">{{ $racha->racha }}</td>
<td class="text-center">{{ $racha->conteo }}</td>
<td class="text-center">{{ $racha->inicio }}</td>
<td class="text-center">{{ $racha->fin }}</td>
</tr>
@endforeach
@endforeach
</tbody>
</table>⚠️ 注意：示例中 $jugador->rachasres 使用了 对象访问语法（->），这要求 $jugadores 中每个元素是 stdClass 对象或 Eloquent 模型。若原始数据是关联数组（如 json_decode($json, true) 返回），请改用数组语法：$jugador['rachasres'] 和 $racha['racha']。
? 关键细节说明
- 外层循环：@foreach ($jugadores as $jugador) 遍历所有球员；
- 内层循环：@foreach ($jugador->rachasres as $racha) 遍历当前球员的每一条连胜记录；
- 字段绑定：$jugador->apodo 属于父级上下文，而 $racha->racha 等属于子级对象，二者作用域清晰分离；
- 结构优势：此方式生成的是单张统一表格（非每人一张表），更符合语义化 HTML 及后续排序、筛选（如 JS DataTables）需求。
? 常见错误与规避建议
- ❌ 错误写法：@foreach ($jugador->rachasres as $jugador) —— 内层变量名与外层冲突，导致覆盖；
- ❌ 忘记空值校验：若某球员 rachasres 为 null 或空数组，会触发 Trying to get property 'racha' of non-object 错误；
✅ 推荐加固写法：@if (!empty($jugador->rachasres)) @foreach ($jugador->rachasres as $racha) <!-- 渲染行 --> @endforeach @endif - ? 进阶提示：如需按“Streak 类型”或“Count 大小”全局排序，建议在控制器中预先 collect($jugadores)->flatMap(...) 扁平化数据，而非在 Blade 中处理逻辑，以保持模板职责单一。
通过以上方式，你既能精准渲染嵌套结构，又能保障代码可维护性与运行健壮性——这是处理多维业务数据（如赛事统计、订单明细、日志轨迹）的通用范式。
立即学习“PHP免费学习笔记（深入）”；
