使用 PHP 动态分组并包裹相同初始字符的元素

原始问题与挑战

在构建动态网页内容时，我们经常需要根据某些条件对列表项进行分组。例如，在一个产品列表中，我们可能希望将所有以字母“C”开头的产品归为一组，以“D”开头的产品归为另一组，并用一个额外的 div 容器将这些同组的产品包裹起来。

最初的 PHP 代码可能如下所示，它会为每个具有不同首字母的组生成一个 h3 标题，然后紧跟着输出该组的 div.item 元素。

    getTitle(), 0, 1);
    ?>
    0-9";
    } else{
        echo "
".strtoupper($stringTitle)."
";
    }?>
    
getId(); ?>

这段代码的输出示例如下：

C
1
2
D
3
4
E
5

然而，我们期望的输出结构是每个 h3 标题后面跟着一个 div.items-add 容器，该容器包裹着所有属于该组的 div.item 元素，例如：

立即学习“PHP免费学习笔记（深入）”；

C

    
1
    
2

D

    
3
    
4

E

    
5

这种结构要求我们在 PHP 循环中智能地判断何时开启新的分组容器，以及何时关闭前一个分组容器。

DiffRhythm

用AI重新定义音乐创作

下载

PHP 服务器端解决方案

实现这种分组逻辑的关键在于引入一个变量来追踪当前分组的标识（例如，标题的首字母），并在每次迭代时将其与当前元素的标识进行比较。当标识发生变化时，意味着一个新的分组开始了，此时我们需要关闭前一个分组的容器（如果存在），然后开启新的 h3 标题和新的分组容器。

以下是优化的 PHP 代码实现：

    getTitle(), 0, 1);
        // 将首字母转换为小写，以便作为ID使用，并进行统一比较
        $normalizedInitial = is_numeric($currentTitleInitial) ? '0-9' : strtolower($currentTitleInitial);
    ?>

    "; // 关闭前一个 

        endif;

        // 输出新的 h3 标题
        if(is_numeric($currentTitleInitial)){
            echo "
0-9
";
        } else{
            echo "
".strtoupper($currentTitleInitial)."
";
        }

        // 开启新的 'items-add' 容器
        echo "
";

        // 更新 $oldTitleInitial 为当前分组的标识
        $oldTitleInitial = $normalizedInitial;
    endif;
    ?>

    
    
getId(); ?>


";
endif;
?>

代码解析：

1. $oldTitleInitial = "";: 初始化一个变量，用于存储上一个处理过的分组的标识。在循环开始前，它为空字符串，表示还没有任何分组。
2. $currentTitleInitial = substr($value->getTitle(), 0, 1);: 从当前元素的标题中提取第一个字符。
3. $normalizedInitial = is_numeric($currentTitleInitial) ? '0-9' : strtolower($currentTitleInitial);: 对提取的首字符进行标准化处理。如果是数字，则统一标识为 '0-9'；否则转换为小写字母。这样做是为了确保比较的准确性，并与 h3 的 id 属性保持一致。
4. if ($normalizedInitial !== $oldTitleInitial): 这是核心逻辑。当当前元素的标准化首字母与上一个不同时，说明一个新的分组开始了。
   • if ($oldTitleInitial !== ""): 如果 $oldTitleInitial 不为空，说明之前已经开启了一个 div.items-add 容器，现在需要将其关闭。
   • 输出 h3 标题: 根据 $currentTitleInitial 是否为数字，输出相应的 h3 标签。
   • echo "
     ";: 开启新的分组容器。
   • $oldTitleInitial = $normalizedInitial;: 更新 $oldTitleInitial，以便在下一次循环中进行比较。
   • php echo $value->getId(); ?>
     : 输出当前元素的 div.item 标签，它将自动被包裹在最近开启的 div.items-add 容器内。
   • 循环后的清理 (if ($oldTitleInitial !== "")): 在 foreach 循环结束后，最后一个 div.items-add 容器可能还没有被关闭。因此，需要在循环外部添加一个检查，确保所有已开启的容器都被正确关闭。

   注意事项

   • 数据预处理: 确保 $forlop 数据源是按照标题首字母排序的。如果数据是无序的，此分组逻辑将无法正确工作，因为相同首字母的元素可能不会连续出现。通常，在从数据库查询数据时，可以通过 ORDER BY title ASC 来实现排序。
   • ID 的唯一性: h3 标签的 id 属性在整个文档中应该是唯一的。在上述解决方案中，我们使用小写字母或 'other' 作为 id，这通常能保证唯一性，但仍需确保标题首字母不会产生冲突的 id。
   • 服务器端渲染优势: 这种在 PHP 中直接生成分组结构的方案是服务器端渲染（SSR）的典型应用。它在页面加载时就提供了完整的、结构化的 HTML，对 SEO 友好，且用户无需等待 JavaScript 执行即可看到完整内容，提升了首次内容绘制（FCP）性能。
   • 客户端方案对比: 虽然也可以使用 jQuery 等客户端 JavaScript 库在页面加载后对 DOM 进行操作来达到同样的效果（如使用 wrapAll() 或 nextUntil()），但服务器端解决方案通常更高效，尤其是在数据量较大时，可以减少客户端的计算负担和潜在的页面闪烁（FOUC）。客户端方案适用于无法修改服务器端代码，或需要更灵活的动态交互场景。

   总结

   通过在 PHP 循环中引入一个状态变量来追踪当前分组的标识，我们可以有效地在服务器端动态生成复杂的分组 HTML 结构。这种方法不仅保证了输出的正确性和清晰度，也充分利用了服务器端渲染的优势，为用户提供了更好的体验。遵循上述教程中的逻辑和注意事项，您将能够灵活地处理各种元素分组需求。