PHP动态分组与容器包裹技巧

一、问题背景与目标

在动态网页开发中，经常需要从数据库或其他数据源获取一系列数据，并将其展示在页面上。一个常见的需求是，将具有某种共同特征（例如，商品列表按首字母分组、新闻按日期分组）的元素进行归类，并在每个类别下使用一个额外的容器标签将这些元素包裹起来。

假设我们有一个商品列表，需要根据商品标题的首字母（或数字）进行分组，并在每个分组下，将所有商品项包裹在一个 div.items-add 容器中。

原始输出结构（示例）：

C
1
2

D
3
4

E
5

期望输出结构：

C

    
1
    
2

D

    
3
    
4

E

    
5

最初的PHP循环可能只是简单地迭代数据，为每个分组生成一个 h3 标题，然后直接输出 div.item。这种方式无法实现 div.items-add 的包裹。虽然可以通过前端 JavaScript（如 jQuery 的 wrapAll()）来实现，但更推荐在服务器端（PHP）直接生成所需的HTML结构，以提高页面加载效率和减少客户端处理负担。

二、PHP解决方案：基于状态变量的条件渲染

解决此问题的核心思想是维护一个“当前分组键”的状态变量。在遍历数据时，我们比较当前项的分组键与上一个项的分组键。如果分组键发生变化，则意味着一个新的分组开始，此时我们需要：

1. 如果上一个分组存在，则关闭上一个分组的 div.items-add 容器。
2. 生成新的 h3 标题。
3. 打开新的 div.items-add 容器。
4. 更新状态变量为当前分组键。

示例代码：

 'Carrots', 'id' => 1],
    (object)['title' => 'Cabbage', 'id' => 2],
    (object)['title' => 'Dates', 'id' => 3],
    (object)['title' => 'Doughnuts', 'id' => 4],
    (object)['title' => 'Eggs', 'id' => 5],
    (object)['title' => 'Apple', 'id' => 6] // 添加一个新分组测试
];

$oldGroupKey = ""; // 用于存储上一个分组的键，初始为空

foreach ($forlop as $value) :
    // 提取标题的首字母
    $stringTitle = substr($value->getTitle(), 0, 1);
    // 确定当前项的分组键（例如：'c', 'd', 'e' 或 '0-9'）
    $currentGroupKey = is_numeric($stringTitle) ? '0-9' : strtolower($stringTitle);

    // 检查分组键是否发生变化
    if ($oldGroupKey !== $currentGroupKey) :
        // 如果不是第一个分组，则需要关闭上一个分组的容器
        if ($oldGroupKey !== "") :
            echo "