当前位置：首页 > 文章列表 > 文章 > php教程 > TinyButStrong整合Dompdf：高效生成HTML转PDF

TinyButStrong整合Dompdf：高效生成HTML转PDF

2025-12-16 17:16:38 0浏览收藏

推广推荐

支持 PC / 移动端，安全直达

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《TinyButStrong整合Dompdf：高效生成HTML转PDF》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

TinyButStrong与Dompdf集成：高效生成HTML并转换为PDF

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：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>[var.document_title]</title>
    <style>
        body { font-family: sans-serif; margin: 20px; }
        h1 { color: #333; }
        p { line-height: 1.6; }
        .data-table { width: 100%; border-collapse: collapse; margin-top: 20px; }
        .data-table th, .data-table td { border: 1px solid #ddd; padding: 8px; text-align: left; }
        .data-table th { background-color: #f2f2f2; }
    </style>
</head>
<body>
    <h1>欢迎来到 [var.company_name]</h1>
    <p>这份报告生成于：[var.report_date]</p>

    <h2>数据详情</h2>
    <table class="data-table">
        <thead>
            <tr>
                <th>项目</th>
                <th>描述</th>
                <th>值</th>
            </tr>
        </thead>
        <tbody>
            [row.item;block=tr]
            <tr>
                <td>[item.name]</td>
                <td>[item.description]</td>
                <td>[item.value]</td>
            </tr>
            [/row.item]
        </tbody>
    </table>

    <p>感谢您的阅读。</p>
</body>
</html>

在这个模板中：

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

2. 使用TinyButStrong生成HTML内容

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

<?php
// 引入TinyButStrong库
require_once 'tbs_class_php5.php'; // 假设tbs_class_php5.php在当前目录

// 实例化TinyButStrong
$TBS = new clsTinyButStrong;

// 设置HTML模板文件路径
$templatePath = 'template.html';

// 加载HTML模板
// 注意：这里不需要使用OPENTBS_PLUGIN
$TBS->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）等安全漏洞。