TinyButStrong (TBS) 是一个通用的模板引擎，适用于处理包括HTML在内的任何文本模板，而OpenTBS是其专门用于处理Office文档（如DOCX、XLSX）的插件。本文将详细阐述如何利用TinyButStrong本身来生成标准的HTML内容，从而作为Dompdf的有效输入，实现从模板到HTML再到PDF的转换流程，避免将OpenTBS误用于HTML生成。

理解TinyButStrong与OpenTBS的角色

在深入探讨解决方案之前，明确TinyButStrong (TBS) 及其插件OpenTBS各自的功能至关重要。

• TinyButStrong (TBS)：这是一个强大的PHP模板引擎，设计初衷是与任何文本模板协同工作。它能够解析模板文件，并将数据动态地合并到其中。这意味着TBS非常适合用于生成HTML页面、XML文件、纯文本报告等。它的核心能力在于处理占位符（例如[var.field]），并用实际数据替换它们。

• OpenTBS 插件：OpenTBS是TinyButStrong的一个特定插件，其主要目的是扩展TBS的功能，使其能够处理Microsoft Office和LibreOffice文档。这些文档在技术上是ZIP压缩包，内部包含XML子文件。没有OpenTBS，TinyButStrong无法直接解析或修改这些复杂的Office文档结构。

因此，当目标是生成HTML页面以供Dompdf转换为PDF时，正确的做法是直接使用TinyButStrong核心引擎，而不是OpenTBS插件。OpenTBS是针对Office文档的，不适用于生成纯HTML。

使用TinyButStrong生成HTML

要为Dompdf生成有效的HTML输入，我们应该将TinyButStrong指向一个HTML模板文件。以下是具体步骤和示例代码：

1. 准备HTML模板文件

首先，创建一个包含TBS占位符的HTML模板文件。例如，保存为 template.html：

    
    
    
    



    
欢迎来到 [var.company_name]
    
这份报告生成于：[var.report_date]

    
数据详情
    
            [row.item;block=tr]
            
            [/row.item]
        

        

            

                
项目
                
描述
                
值
            
        
        

                
[item.name]
                
[item.description]
                
[item.value]
            
    

    
感谢您的阅读。

在这个模板中：

• [var.document_title]、[var.company_name]、[var.report_date] 是用于单个变量的占位符。
• [row.item;block=tr] 和 [item.name] 等是用于循环生成表格行的块（block）占位符。

2. 使用TinyButStrong生成HTML内容

接下来，编写PHP代码来加载这个HTML模板，填充数据，并生成最终的HTML字符串。

LoadTemplate($templatePath, 'UTF-8'); // 指定模板编码

// 准备要填充的数据
$data = array(
    'document_title' => '公司年度报告',
    'company_name'   => '示例科技公司',
    'report_date'    => date('Y-m-d'),
    'items'          => array(
        array('name' => '产品A', 'description' => '一款创新型软件', 'value' => '12000'),
        array('name' => '服务B', 'description' => '专业咨询服务', 'value' => '8500'),
        array('name' => '硬件C', 'description' => '高性能服务器', 'value' => '25000'),
    )
);

// 将数据分配给TBS
// 使用MergeBlock方法处理循环数据
$TBS->MergeBlock('item', $data['items']);

// 使用MergeField方法处理单个变量
$TBS->MergeField('var', $data); // 或者 $TBS->SetData($data, 'var');

// 生成HTML内容
// 使用TBS_OUTPUT_STRING参数将输出捕获为字符串
$htmlContent = $TBS->Show(TBS_OUTPUT_STRING);

// 现在 $htmlContent 包含了填充了数据的完整HTML字符串
echo $htmlContent;

// 示例：将生成的HTML传递给Dompdf（需要Dompdf库）
/*
require_once 'dompdf/autoload.inc.php'; // 假设dompdf在dompdf子目录

use Dompdf\Dompdf;
use Dompdf\Options;

// 实例化Dompdf并设置选项
$options = new Options();
$options->set('isHtml5ParserEnabled', true);
$options->set('isRemoteEnabled', true); // 如果HTML包含远程图片或样式，需要启用
$dompdf = new Dompdf($options);

// 加载HTML内容
$dompdf->loadHtml($htmlContent);

// 设置纸张大小和方向
$dompdf->setPaper('A4', 'portrait');

// 渲染HTML为PDF
$dompdf->render();

// 输出PDF到浏览器或保存到文件
$dompdf->stream("report.pdf", array("Attachment" => false)); // 直接在浏览器中显示
// file_put_contents("report.pdf", $dompdf->output()); // 保存到文件
*/

?>

在这段PHP代码中：

1. 我们只引入了 tbs_class_php5.php，没有引入OpenTBS插件。
2. $TBS->LoadTemplate($templatePath, 'UTF-8'); 加载HTML模板。第二个参数指定了模板的编码。
3. $TBS->MergeBlock('item', $data['items']); 用于处理模板中的 [row.item;block=tr] 循环块，将 $data['items'] 数组中的每个元素填充到表格行中。
4. $TBS->MergeField('var', $data); 用于处理模板中的 [var.field] 形式的单个变量。
5. $htmlContent = $TBS->Show(TBS_OUTPUT_STRING); 是关键一步，它指示TBS执行合并操作，并将最终生成的HTML作为字符串返回，而不是直接输出到浏览器。

3. 将HTML传递给Dompdf

获取到 $htmlContent 字符串后，就可以将其作为输入传递给Dompdf库，以生成PDF文件。上述PHP代码的注释部分展示了Dompdf的基本用法。

注意事项与最佳实践

1. 区分工具用途：始终牢记TinyButStrong用于通用文本模板（包括HTML），而OpenTBS专门用于Office文档。选择正确的工具可以避免不必要的复杂性。
2. 模板编码：确保你的HTML模板文件和PHP代码中加载模板时指定的编码（如UTF-8）一致，以避免乱码问题。
3. Dompdf兼容性：生成的HTML应尽量符合Web标准，以便Dompdf能够正确解析和渲染。复杂的CSS或JavaScript可能不会被Dompdf完全支持。
4. 错误处理：在实际项目中，应加入适当的错误处理机制，例如检查模板文件是否存在、数据是否有效等。
5. 性能优化：对于大型数据量或高并发场景，考虑缓存生成的HTML或PDF，以提高系统性能。
6. 安全性：如果模板内容或数据来自用户输入，请务必进行适当的清理和验证，以防止跨站脚本（XSS）等安全漏洞。

总结

通过上述方法，我们可以清晰地将TinyButStrong作为HTML模板引擎，生成规范的HTML内容，然后无缝地集成Dompdf进行PDF转换。这种分离关注点的方式，不仅提高了代码的可维护性，也确保了每个工具都能在其最擅长的领域发挥作用，从而构建出高效且健壮的文档生成解决方案。