如何在 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';
}

	' . esc_html(get_sub_field('name')) . '
Voltage

? 关键要点说明：

必须两次遍历：第一次提取原始数据（$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']) 这类关联数组方案——它解决的是「全局去重计数」，而本需求是「连续段计数」，二者逻辑本质不同。