tcpdf纯php生成pdf，适合嵌入式与敏感数据场景；wkhtmltopdf基于webkit，还原前端效果强。两者均需正确配置中文字体、分页及性能优化策略。
如果您在PHP项目中需要生成包含复杂样式、图表和多语言支持的业务报表PDF，Tcpdf与Wkhtmltopdf是两种主流且差异显著的技术选型。以下是针对实际部署场景中实现高质量PDF输出的具体方法：
一、使用Tcpdf生成带中文与表格的PDF
Tcpdf是一个纯PHP编写的PDF生成库，无需外部依赖，适合对服务器环境控制严格、需嵌入式生成或处理敏感数据的场景。它原生支持UTF-8中文，但需正确加载中文字体以避免乱码或方块。
1、下载并解压Tcpdf库至项目vendor目录，确保其路径可被自动加载或手动引入tcpdf.php。
2、准备一个支持中文的TrueType字体文件（如simhei.ttf），将其复制到tcpdf/fonts/目录下，并运行tools/tcpdf_addfont.php脚本生成PHP字体描述文件。
3、在PHP代码中初始化Tcpdf实例，设置页面方向、单位和字体：new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false)。
4、调用setFont()方法加载已注册的中文字体，例如：$pdf->setFont('simhei', '', 12)。
5、使用writeHTML()方法传入含HTML标签的报表内容（支持table、img、style内联样式），再调用Output()输出PDF流或保存为文件。
二、使用Wkhtmltopdf通过HTML模板渲染PDF
Wkhtmltopdf基于WebKit引擎，能精准还原CSS布局、响应式设计及JavaScript动态内容，适用于报表需高度复现前端展示效果的场景。其依赖系统级二进制程序，部署时需确保执行权限与字体路径配置正确。
1、在Linux服务器上通过apt或yum安装wkhtmltopdf二进制包，或从官网下载静态编译版本并赋予可执行权限：chmod +x /usr/local/bin/wkhtmltopdf。
2、创建标准HTML模板文件，内联关键CSS样式（避免外部引用失败），确保中文字体通过@font-face声明并指向服务器绝对路径。
3、使用PHP的exec()或proc_open()调用命令行生成PDF：wkhtmltopdf --encoding utf-8 --page-size a4 --margin-top 10 --margin-bottom 10 input.html output.pdf。
4、若需动态传参，将HTML模板交由PHP输出缓冲捕获后写入临时文件，再作为input.html传入；生成完毕立即unlink()清理临时文件。
三、解决中文字体缺失导致的乱码问题
无论采用Tcpdf还是Wkhtmltopdf，中文显示异常均大概率源于字体未正确加载或路径不可达。两者处理机制不同，需分别应对。
1、Tcpdf中确认fonts目录下存在对应字体的PHP数组文件（如simhei.php）及ttf文件，且文件权限为644，Web用户可读。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
2、Wkhtmltopdf中在HTML模板顶部添加meta charset声明，并在CSS中显式指定font-family：body { font-family: "SimHei", "DejaVu Sans", sans-serif; }。
3、Linux系统下检查系统字体缓存是否包含中文字体：fc-list :lang(zh)；若无结果，将字体复制至/usr/share/fonts/并执行fc-cache -fv。
4、在Wkhtmltopdf命令中强制指定字体路径：--font-path /usr/share/fonts/truetype/simhei/。
四、处理分页与页眉页脚的动态内容
业务报表常需每页固定页眉、页脚、页码及跨页表格断行控制。Tcpdf提供内置页眉页脚钩子，Wkhtmltopdf则依赖CSS Paged Media语法与JavaScript注入。
1、Tcpdf中重写Header()与Footer()方法，在其中调用Cell()或writeHTMLCell()绘制固定区域内容，并用getAliasNumPage()获取当前页码。
2、启用Tcpdf的keepTogether功能防止表格行被截断：$pdf->setPageBreaks(false); $pdf->setAutoPageBreak(TRUE, PDF_MARGIN_BOTTOM);。
3、Wkhtmltopdf中使用@page规则定义页边距与尺寸，并在HTML中添加带有position: running()的元素实现页眉页脚流动绑定。
4、通过JavaScript在页面加载完成后注入页码：在body末尾添加script标签，调用window.status = 'PAGE ' + (window.location.href.split('#')[1] || 1)，配合--run-script参数启用JS执行。
五、提升生成性能与并发稳定性
高并发生成PDF易引发内存溢出、进程阻塞或超时中断。需从资源限制、缓存策略与异步机制三方面优化。
1、为Tcpdf实例设置内存限制：ini_set('memory_limit', '512M');，并在生成前调用ob_end_clean()清除输出缓冲。
2、Wkhtmltopdf命令中添加超时与资源约束参数：--load-error-handling ignore --javascript-delay 500 --no-stop-slow-scripts --max-width 1920。
3、对静态报表模板启用OPcache加速PHP解析，对HTML模板启用file_get_contents()缓存或Redis存储已渲染HTML片段。
4、将PDF生成任务推入消息队列（如Redis List或Beanstalkd），由独立Worker进程消费，避免Web请求阻塞主线程。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
