Smarty 模板中实现多维数组按字段分组并拼接值的完整方案-php教程-PHP中文网

Smarty 模板中实现多维数组按字段分组并拼接值的完整方案

本文详解如何在不修改原始 PHP 数据的前提下，仅通过 Smarty 模板语法（v3+）对多维数组按指定键（如 name）分组，并将对应值（如 value）以逗号分隔形式聚合输出为定义列表（）。

本文详解如何在不修改原始 php 数据的前提下，仅通过 smarty 模板语法（v3+）对多维数组按指定键（如 `name`）分组，并将对应值（如 `value`）以逗号分隔形式聚合输出为定义列表（`

`）。

在 Smarty 模板开发中，常遇到后端传入的是扁平化多维数组（如产品特性列表），但前端需按分类逻辑渲染——例如将同名属性（Paper）的多个取值（A4, A5）合并显示。由于无法改动 PHP 层数据结构，必须纯模板内完成分组与拼接。Smarty 原生不支持 GROUP BY 类 SQL 语义，但可通过其变量赋值与数组操作能力实现等效效果。

核心思路：两阶段模板处理

首先利用 Smarty 的动态变量赋值语法构建分组关联数组；再遍历该分组数组，结合 implode 修饰器完成值拼接。

第一步：构建分组数组

使用 {foreach} 遍历原始 $products，将每个 $feature.value 追加到以 $feature.name 为键的二维数组中：

{foreach from=$products item=feature}
    {$grouped[$feature.name][] = $feature.value}
{/foreach}

✅ 关键说明：

{$grouped[$feature.name][] = ...} 是 Smarty 的模板级数组追加语法，等效于 PHP 的 $grouped[$name][] = $value；

此处 [] 表示自动索引追加，无需预先声明 $grouped；

执行后，$grouped 将变为类似 ['Fabric' => ['Silk'], 'Paper' => ['A4', 'A5']] 的结构。

第二步：渲染分组定义列表

基于新生成的 $grouped 数组，遍历其键（key）与值（item），用 implode 修饰器连接值数组：

{$name}: {", "|implode:$values}

? {" , "|implode:$values} 含义：以字符串 ", " 为分隔符，将 $values 数组元素拼接为单个字符串。Smarty 会自动忽略末尾空格，输出 A4, A5（非 A4, A5,）。

完整可运行示例

假设 $products 如题所给：

$products = [
    ['name' => 'Fabric', 'value' => 'Silk'],
    ['name' => 'Paper',  'value' => 'A4'],
    ['name' => 'Paper',  'value' => 'A5'],
];
$smarty->assign('products', $products);

对应 .tpl 文件内容：

{foreach from=$products item=feature}
    {$grouped[$feature.name][] = $feature.value}
{/foreach}

{$name}: {", "|implode:$values}

最终输出 HTML 符合预期：

Fabric: Silk
Paper: A4, A5

注意事项与最佳实践

⚠️ Smarty 版本要求：该方案适用于 Smarty 3.x 及以上版本；Smarty 2 不支持 [] 数组追加语法，需升级或改用 PHP 预处理。
⚠️ 变量作用域：$grouped 是模板局部变量，仅在当前 .tpl 文件内有效，不会污染全局变量空间。
✅ 性能提示：对于超大数据集（>1000 条），建议在 PHP 层预分组，模板层仅负责渲染，避免模板引擎承担过多逻辑。
✅ 扩展性：若需支持其他分隔符（如分号）、去重或排序，可在 PHP 层封装函数后通过 registerPlugin 注入模板，保持模板简洁性。

此方案以最小侵入方式解决了纯模板环境下的分组聚合需求，是 Smarty 高级模板技巧的典型应用。