如何在 Twig 模板中按分组名称（如国家）组织并显示数据列表-php教程-PHP中文网

如何在 Twig 模板中按分组名称（如国家）组织并显示数据列表

本文介绍如何将扁平数组按 group_name 字段分组，并在 Twig 模板中优雅地渲染为「分组标题 + 对应子项」结构，避免模板内复杂逻辑，推荐在 PHP 层预处理数据。

本文介绍如何将扁平数组按 `group_name` 字段分组，并在 twig 模板中优雅地渲染为「分组标题 + 对应子项」结构，避免模板内复杂逻辑，推荐在 php 层预处理数据。

在 Twig 中直接对未分组的数组实现「每组仅显示一次组名，再列出所有同组状态」的需求，容易陷入重复渲染或条件判断混乱的问题——正如原始代码中尝试用 for 循环配合 dump() 却无法识别组边界。最佳实践是：不在 Twig 中做分组逻辑，而是在 PHP 控制器层完成数据预处理，将原始数组转换为以 group_name 为键、对应状态列表为值的嵌套关联数组。

✅ 推荐做法：PHP 层预分组（简洁可靠）

假设你从数据库或 API 获取到原始 $places 数组：

$places = [
    ['id' => 1, 'group_name' => 'usa', 'state' => 'San Francisco'],
    ['id' => 2, 'group_name' => 'usa', 'state' => 'Texas'],
    ['id' => 3, 'group_name' => 'usa', 'state' => 'North Carolina'],
    ['id' => 4, 'group_name' => 'aus', 'state' => 'Darwin'],
    ['id' => 5, 'group_name' => 'aus', 'state' => 'Melbourne'],
    ['id' => 6, 'group_name' => 'usa', 'state' => 'Perth'], // 注意：原文示例含 typo（"Perth" 实际属 Australia，此处按数据原样处理）
];

// ✅ 关键步骤：按 group_name 分组
$groupedPlaces = [];
foreach ($places as $place) {
    $key = strtolower($place['group_name']); // 可选：统一转小写避免大小写敏感
    $groupedPlaces[$key][] = [
        'id'   => $place['id'],
        'state' => $place['state']
    ];
}

最终 $groupedPlaces 结构如下（已适配 Twig 渲染需求）：

[
  'usa' => [
    ['id' => 1, 'state' => 'San Francisco'],
    ['id' => 2, 'state' => 'Texas'],
    ['id' => 3, 'state' => 'North Carolina'],
    ['id' => 6, 'state' => 'Perth'],
  ],
  'aus' => [
    ['id' => 4, 'state' => 'Darwin'],
    ['id' => 5, 'state' => 'Melbourne'],
  ]
]

然后将其传递给 Twig 模板：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

return $this->render('places/index.html.twig', [
    'grouped_places' => $groupedPlaces,
]);

✅ Twig 模板：清晰、无逻辑负担

{# places/index.html.twig #}
{% for group_name, states in grouped_places %}
  <h3>Group Name: {{ group_name|upper }}</h3>
  {% for state_item in states %}
    <p>State: {{ state_item.state }}</p>
  {% endfor %}
  <br>{# 可选：组间空行 #}
{% endfor %}

输出效果完全匹配预期：

Group Name: USA
State: San Francisco
State: Texas
State: North Carolina
State: Perth

Group Name: AUS
State: Darwin
State: Melbourne

⚠️ 注意事项与优化建议

不要在 Twig 中做分组：Twig 是模板引擎，非数据处理工具。强行使用 loop.index, loop.prev, loop.next 或自定义 Twig 扩展实现分组，会显著降低可读性与可维护性。
大小写标准化：如示例中 usa/USA/Usa 应统一处理（推荐 PHP 层 strtolower()），避免因大小写差异导致分组失败。
空组容错：可在 Twig 中添加 {% if states|length %} 判断，避免空数组渲染。
性能考虑：若数据量极大（>10k 条），建议在数据库层使用 GROUP BY 或 array_reduce() 替代 foreach，但常规业务场景无需过度优化。
扩展性提示：如需支持多级分组（如 country → region → city），可递归构建嵌套数组，Twig 层仍保持简洁遍历。

通过「PHP 预分组 + Twig 纯展示」的职责分离模式，你既能获得清晰的模板逻辑，又能确保数据结构健壮、易于测试与复用。