问题：如何在ThinkPHP5中实现PDF文件导出功能？

Question

在ThinkPHP5中实现PDF文件导出功能，常见的技术问题包括：如何选择合适的PDF生成库（如TCPDF、FPDF或DomPDF），如何在控制器中正确引入并实例化PDF类，如何处理中文字符显示乱码问题，以及如何将HTML内容或数据库数据渲染为PDF并实现文件下载。此外，还需解决PDF样式布局、分页控制、图片与表格嵌入等实际问题，以确保导出的PDF内容准确、格式美观。

Answer 1

一、选择合适的PDF生成库

在ThinkPHP5中实现PDF导出功能，首先需要选择一个合适的PDF生成库。常见的库有：

• FPDF：轻量级、速度快，但不支持复杂的HTML/CSS渲染，中文支持较差。
• TCPDF：功能强大，支持Unicode、中文、表格、图片等，适合复杂文档。
• DomPDF：基于HTML/CSS渲染PDF，适合前端开发者，样式控制更灵活。

根据项目需求选择：

特性	FPDF	TCPDF	DomPDF
中文支持	差	好	一般
HTML/CSS 渲染	无	有限	强
文档复杂度	低	高	中

二、在控制器中引入并实例化PDF类

以TCPDF为例，在ThinkPHP5中引入第三方库需要使用命名空间或手动加载类文件。

步骤如下：

1. 将TCPDF库放入vendor目录，如vendor/tcpdf。
2. 在控制器中使用require_once引入核心类文件。
3. 实例化TCPDF类并调用相关方法。

namespace app\index\controller;

use think\Controller;

class Pdf extends Controller {
    public function export() {
        require_once ROOT_PATH . 'vendor/tcpdf/tcpdf.php';
        $pdf = new \TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);
        $pdf->SetCreator(PDF_CREATOR);
        $pdf->SetTitle('示例PDF');
        $pdf->AddPage();
        $pdf->SetFont('stsongstdlight', '', 14);
        $pdf->Write(0, '这是一个PDF导出示例内容。', '', 0, 'C', true, 0, false, false, 0);
        $pdf->Output('example.pdf', 'D');
        exit;
    }
}
    

三、处理中文字符显示乱码问题

TCPDF和DomPDF在处理中文时容易出现乱码，解决方法如下：

• 对于TCPDF，需使用支持中文的字体，例如stsongstdlight（宋体）或自行添加中文字体文件。
• DomPDF可通过配置dompdf_font_family_cache或使用@font-face引入中文字体。

示例代码（TCPDF中添加中文字体）：

$pdf = new \TCPDF();
$pdf->AddFont('SimSun', '', 'simsun.php');
$pdf->SetFont('SimSun', '', 12);
    

四、将HTML内容或数据库数据渲染为PDF并实现下载

以DomPDF为例，展示如何从HTML模板生成PDF：

use Dompdf\Dompdf;

class Pdf extends Controller {
    public function exportHtml() {
        $data = Db::name('content')->select();
        $html = $this->fetch('pdf_template', ['data' => $data]);
        $dompdf = new Dompdf();
        $dompdf->loadHtml($html);
        $dompdf->setPaper('A4', 'portrait');
        $dompdf->render();
        $dompdf->stream("output.pdf", array("Attachment" => 1));
        exit;
    }
}
    

其中pdf_template.html为包含HTML内容的模板文件。

五、PDF样式布局与分页控制

在PDF中实现样式美观和分页控制是关键问题，常见方法包括：

• 使用CSS控制字体、颜色、边距等样式。
• 使用page-break-inside或page-break-after控制分页。
• 在TCPDF中通过AddPage()手动添加新页。

CSS示例：

<style>
    .page-break {
        page-break-after: always;
    }
</style>

    

六、图片与表格嵌入技巧

在PDF中插入图片和表格是常见需求，处理方式如下：

• 图片需使用绝对路径或Base64编码嵌入。
• 表格可使用HTML标签（DomPDF）或TCPDF的Cell()、MultiCell()方法。

示例流程图（Mermaid格式）：

graph TD
    A[开始] --> B[准备HTML内容]
    B --> C{是否包含图片/表格}
    C -->|是| D[处理图片路径]
    C -->|否| E[直接渲染]
    D --> F[使用Base64编码图片]
    E --> G[生成PDF并下载]
    F --> G