如何在 PHP 中动态生成带 colspan 的表格（按连续相同值合并单元格）

本文讲解如何在 php（特别是 wordpress acf 环境下）遍历数据时，智能识别 ** 连续重复值 ** 并为表格 `

` 正确设置 `colspan`，避免因状态重置错误导致的重复计数问题。核心在于使用「分组计数 + 首次标记」逻辑，而非全局变量累加。

在动态生成产品规格表（如电压、颜色、尺寸等横向对比）时，常见需求是：当某字段（如 voltage）出现 连续相同值（如 12, 12, 24, 24），对应

应合并为 colspan=”2″ 的单个单元格；而若值交替出现（如 12, 24, 12, 24），则每个值均需独立单元格（colspan=”1″）。原代码失败的根本原因在于：它用单一变量 $voltagecount 跟踪全局计数，却未区分「当前连续段起始位置」与「是否为该段首个元素」，导致每次匹配都重复追加 ，造成冗余渲染。

✅ 正确解法是采用 “滑动窗口式分组计数”：仅当值发生变化时才输出上一段的合并单元格，并重置计数器。无需关联数组或复杂键名——只需两个状态变量：

• $currentVoltage：记录上一次读取的电压值（用于比对）
• $spanCount：记录当前连续相同值已出现的次数

以下是重构后的核心逻辑（适配 WordPress ACF have_rows() 循环）：

if (have_rows('product_variations')) {// 初始化状态变量（注意：初始值设为 null 或空字符串，确保首次必触发输出）$currentVoltage = null;     $spanCount = 0;     $pvoltage = ''; // 存储最终电压行 td 字符串      // 第一次遍历：收集所有电压值到数组（便于后续分组处理，更清晰可控）$voltages = [];     while (have_rows('product_variations')) : the_row();         $voltages[] = get_sub_field('voltage');     endwhile;      // 第二次遍历：按连续相同值分组，生成 colspan     for ($i = 0; $i < count($voltages); $i++) {$v = $voltages[$i];         if ($v === $currentVoltage) {// 值相同：仅增加计数             $spanCount++;} else {// 值变化：先输出上一组（若存在），再重置             if ($currentVoltage !== null) {$pvoltage .=''. esc_html($currentVoltage) .'';             }             $currentVoltage = $v;             $spanCount = 1; // 新组从 1 开始         }     }     // 循环结束后，输出最后一组     if ($currentVoltage !== null) {$pvoltage .=''. esc_html($currentVoltage) .'';     }      // 构建完整表格（其他字段同理可复用此模式）$output ='';     $output .='';     // 动态生成表头（name 字段）rewind_rows('product_variations'); // 重置 ACF 行指针     while (have_rows('product_variations')) : the_row();         $output .='';     endwhile;     $output .='';      // 电压行     if (!empty($pvoltage)) {$output .=''. $pvoltage .'';     }      $output .='
'. esc_html(get_sub_field('name')) .'
Voltage
'; }

? 关键要点说明：

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

• 必须两次遍历：第一次提取原始数据（$voltages），第二次专注分组逻辑。这避免了在 ACF the_row() 中混杂状态管理带来的混乱；
• rewind_rows() 必不可少：在生成表头前重置 ACF 行指针，否则后续循环会跳过数据；
• esc_html() 安全过滤：防止 XSS，生产环境必须添加；
• colspan=”1″ 可省略：HTML 规范中 colspan=”1″ 是默认行为，实际可不写，但保留更语义清晰；
• 扩展性设计：将此逻辑封装为函数，可复用于 color、depth 等任意字段：

  function buildColspanCells($values, $align = 'center') {if (empty($values)) return '';     $html =''; $current = null; $count = 0;     foreach ($values as $v) {if ($v === $current) {$count++;} else {if ($current !== null) {$html .= '' . esc_html($current) . '';             }             $current = $v;             $count = 1;         }     }     if ($current !== null) {$html .= '' . esc_html($current) . '';     }     return $html; } // 使用：$pvoltage = buildColspanCells($voltages);

⚠️ 常见陷阱规避：

• ❌ 不要试图在单次 while (have_rows()) 中同时读取和输出——ACF 的内部指针与自定义计数器易冲突；
• ❌ 避免用字符串拼接计数器（如 $voltagecount = ‘1’），应始终用整型（$spanCount = 1）；
• ❌ 不要依赖 isset($voltagecount[‘key’]) 这类关联数组方案——它解决的是「全局去重计数」，而本需求是「连续段计数」，二者逻辑本质不同。

通过这种清晰的两阶段处理（采集 → 分组），代码可读性 、可维护性与健壮性大幅提升，轻松应对 12,12,24,24 或 12,24,12,24 等任意 排列 组合。