使用TBS MergeBlock时ope=tbs:num选项失效问题咨询

核心问题 #

传给MergeBlock的数字均为字符串类型，且小数分隔符混用逗号和点，导致Excel识别为文本；使用;ope=tbs:num时，该操作仅支持PHP原生数值类型，字符串格式的数字（尤其是带逗号的）无法被解析，因此生成空单元格——单次合并能生效是场景逻辑差异导致的偶然情况。

解决步骤 #

1. 预处理数据：将字符串数字转为PHP数值类型 #

在构建$rows数组时，针对quantity、price这类数字字段统一格式，转换为float类型：

foreach ($lines->children() as $child) {    
    $row = array();
    foreach ($child->attributes() as $a => $b) {
        $value = $b->__toString();
        // 统一数字格式，转换为数值类型
        if (in_array($a, ['quantity', 'price'])) {
            $value = str_replace(',', '.', $value);
            $value = (float)$value;
        }
        $row[$a] = $value;
    } 
    $rows[] = $row;
}

2. 调整tbs:num使用（或直接省略） #

• 确保模板中的块变量与MergeBlock的块名完全匹配，比如MergeBlock('a', $rows)对应模板中的[a.quantity;ope=tbs:num]；
• 数据转为数值类型后，无需tbs:numExcel也能自动识别为数字，直接消除“文本形式存储”的警告。

3. 提前设置模板单元格格式 #

在Excel模板中，将数字对应的单元格格式设置为数值/货币格式，提前定义显示规则，避免Excel自动识别异常。

额外提醒 #

• 移除utf8_encode($linekey)：OpenTBS 3.x版本无需手动编码块名，直接使用$TBS->MergeBlock($linekey, $rows)即可，编码可能导致块匹配失败；
• 你使用的TBS 3.15.0与OpenTBS 1.12.1版本兼容，无需更换版本。

内容的提问来源于stack exchange，提问作者b2vincent