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.document_title]
欢迎来到 [var.company_name]
这份报告生成于：[var.report_date]
数据详情
| 项目 | 描述 | 值 |
|---|---|---|
| [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代码中：
- 我们只引入了 tbs_class_php5.php，没有引入OpenTBS插件。
- $TBS->LoadTemplate($templatePath, 'UTF-8'); 加载HTML模板。第二个参数指定了模板的编码。
- $TBS->MergeBlock('item', $data['items']); 用于处理模板中的 [row.item;block=tr] 循环块，将 $data['items'] 数组中的每个元素填充到表格行中。
- $TBS->MergeField('var', $data); 用于处理模板中的 [var.field] 形式的单个变量。
- $htmlContent = $TBS->Show(TBS_OUTPUT_STRING); 是关键一步，它指示TBS执行合并操作，并将最终生成的HTML作为字符串返回，而不是直接输出到浏览器。
3. 将HTML传递给Dompdf
获取到 $htmlContent 字符串后，就可以将其作为输入传递给Dompdf库，以生成PDF文件。上述PHP代码的注释部分展示了Dompdf的基本用法。
注意事项与最佳实践
- 区分工具用途：始终牢记TinyButStrong用于通用文本模板（包括HTML），而OpenTBS专门用于Office文档。选择正确的工具可以避免不必要的复杂性。
- 模板编码：确保你的HTML模板文件和PHP代码中加载模板时指定的编码（如UTF-8）一致，以避免乱码问题。
- Dompdf兼容性：生成的HTML应尽量符合Web标准，以便Dompdf能够正确解析和渲染。复杂的CSS或JavaScript可能不会被Dompdf完全支持。
- 错误处理：在实际项目中，应加入适当的错误处理机制，例如检查模板文件是否存在、数据是否有效等。
- 性能优化：对于大型数据量或高并发场景，考虑缓存生成的HTML或PDF，以提高系统性能。
- 安全性：如果模板内容或数据来自用户输入，请务必进行适当的清理和验证，以防止跨站脚本（XSS）等安全漏洞。
总结
通过上述方法，我们可以清晰地将TinyButStrong作为HTML模板引擎，生成规范的HTML内容，然后无缝地集成Dompdf进行PDF转换。这种分离关注点的方式，不仅提高了代码的可维护性，也确保了每个工具都能在其最擅长的领域发挥作用，从而构建出高效且健壮的文档生成解决方案。
