本文介绍如何使用 PHP 的 array_chunk() 函数将 WordPress 分类列表按每组 2 个进行分组，并渲染为结构清晰的 HTML 布局，适用于响应式网格或双列分类展示场景。
本文介绍如何使用 php 的 `array_chunk()` 函数将 wordpress 分类列表按每组 2 个进行分组，并渲染为结构清晰的 html 布局，适用于响应式网格或双列分类展示场景。
在 WordPress 开发中，有时需要将全部分类（categories）以成对形式展示——例如每行两个分类卡片，而非默认的单列垂直排列。原代码的问题在于：嵌套了重复的 get_categories() 调用，且未正确分组逻辑，导致只输出前两项；同时混淆了外层循环与内层截断逻辑，造成语义混乱和不可扩展性。
正确的思路是：先一次性获取所有分类，再用 array_chunk() 按每 2 项切分成子数组，最后遍历每个“块”（chunk）渲染对应 HTML 结构。
以下是推荐的完整实现（兼容 WordPress 主题模板，如 index.php 或自定义页面模板）：
<?php
// 获取所有启用的分类（可选参数：排除特定分类、限制数量等）
$categories = get_categories([
'hide_empty' => false, // 包含无文章的分类（按需调整）
'orderby' => 'name',
'order' => 'ASC'
]);
// 将分类数组按每 2 个一组切分
$chunks = array_chunk($categories, 2);
// 遍历每个 chunk（即每一对分类）
foreach ($chunks as $chunk) :
?>
<div class="box">
<?php foreach ($chunk as $category) : ?>
<p>
<a href="<?php echo esc_url(get_category_link($category->term_id)); ?>">
<?php echo esc_html($category->name); ?>
</a>
</p>
<?php endforeach; ?>
</div>
<?php endforeach; ?>✅ 关键说明：
Chinese Sensitive Words
下载
中文敏感词/违禁词检测与内容合规性检查工具。支持对小红书（Xiaohongshu）、Douyin（抖音）、WeChat（微信）、Weibo（微博）、Bilibili（哔哩哔哩）、Zhihu（知乎）、Taobao（淘宝）、JD.com（京东）等主流平台的禁用词、限用词及高风险词进行文本扫描与合规性分析。
立即学习“PHP免费学习笔记（深入）”；
- array_chunk($categories, 2) 是核心：它将原始一维分类数组转换为二维数组，如 [[cat1, cat2], [cat3, cat4], ...]；
- 每个 $chunk 是一个最多含 2 个元素的子数组，确保 <div class="box"> 内恰好渲染两个 <p> 标签；
- 使用 esc_url() 和 esc_html() 是 WordPress 安全最佳实践，防止 XSS 漏洞；
- 若需展示分类图标（如你原代码中的 z_taxonomy_image_url()），请确保该函数已定义（通常来自插件 Taxonomy Images），并加入到 <img> 标签中：
<img src="<?php echo esc_url(z_taxonomy_image_url($category->term_id)); ?>"
alt="<?php echo esc_attr($category->name); ?>"
width="60" height="60">⚠️ 注意事项：
- 若分类总数为奇数（如 5 个），最后一组仅含 1 项，array_chunk 会自动处理，无需额外判断；
- 避免在循环内重复调用 get_categories() —— 这会显著降低性能，应只调用一次；
- 如需响应式适配（如移动端单列），建议配合 CSS Flexbox 或 Grid 实现，而非 PHP 逻辑控制列数。
通过该方法，你不仅能精准生成所需 HTML 结构，还能轻松扩展为每行 3 个、4 个甚至动态配置列数（只需修改 array_chunk 第二个参数），大幅提升模板的可维护性与灵活性。
