最完美的html转化为pdf的方法

几种常见的html页面转化为pdf的方法

html2canvas+jsPDF

iText

wkhtmltopdf

wkhtmltopdf安装部署，php调用的方法

安装wkhtmltopdf

php调用wkhtmlpdf

composer安装

安装mikehaertl/phpwkhtmltopdf依赖

php调用wkhtmltopdf

心得总结

一、常见的几种html转化pdf方法

最常见的html转化为pdf的方法肯定是在浏览器中ctrl+p的快捷键（windows）就可以直接将页面导出为pdf了，当然这对于用户来说肯定是不够友好的，在网页开发中这肯定也是不合格的。所以引入了下面三种方法。

1. html2canvas+jsPDF

这种方法实质上是一种专门在前端js生成pdf的方法，只要导入几个js文件写一点js调用即可，本质就是使用js遍历页面中都dom节点,然后将其转化为canvas,然后调用jsPDF,将canvas转化为PDF，我也尝试的使用过这种方式生成PDF，使用感受一个是转成的PDF严重失帧，变形严重（当然不排除我html代码规范问题），另一个就是当页数过多时，会导致浏览器死机，速度过慢。

2. iText

这种方法生成的pdf质量会更高，但是在后端实现的步骤过于复杂，而且需要安装字体，对于html代码要求也是比较高，缺少标签的时候会报错，这种方法我没有去尝试过，当时直接被第三种方法给吸引了

3. wkhtmltopdf

这种方式实现比较简单，wkhtmltopdf是一个软件，这个软件生成pdf支持多种方式，可以直接使用网页网址将页面转化为pdf，也可以使用本地的文件将其转为pdf，而且转化结果及其的完美，加上实现的过程比较简单，所以我觉得这是最优的一种html转化为pdf的方式，下面直接上效果图

实际网页

转化pdf效果

转化的结果已经十分完美

我在项目中使用的是php调用wkhtmltopdf去生成pdf，下面内容会详细介绍说明步骤

二、wkhtmltopdf环境安装和使用

使用wkhtmltopdf应用到项目中实际上应该是这样一个过程，服务器安装好wkhtmltopdf软件，php后端将要转化的网页的html代码或者html文件在本地生成pdf，然后将服务器端的pdf发送到前端供用户下载或者浏览，其中php后端调用wkhtmltopdf的方法使用的是composer中的mikehaertl/phpwkhtmltopdf包

1. 安装wkhtmltopdf

安装wkhtmltopdf过程很简单，这里不赘述，在wkhtmltopdf官网选择适合你系统的安装包下载安装即可，安装过程没有难度，一路确定到底就可以，安装完在你电脑里给他增加一个环境变量，将wkhtmltopdf的安装目录下面的bin目录加入环境变量path之中即可。打开命令行输入wkhtmltopdf -V会显示版本号说明安装成功

安装成功

这个时候就可以直接使用软件了你可以简单的使用一下这个软件,直接复制下面的html另存为test.html

<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>Document</title>
</head>
<body>
    <p>hello, you are succeed</p>
</body>
</html>

在cmd命令行中打开test.html所在文件夹然后使用命令wkhtmltopdf test.html test.pdf就会发现当前文件夹下出现了test.pdf的文件

4.jpg

5.jpg

命令中可以使用在线的网址来代替本地html文件，不过一般最好不要在项目中这样使用，因为网页中容易有各种表单参数和iframe容易出错，在项目中使用html文件转化

2. php调用wkhtmlpdf

前面说了一大串，但是其实都是比较简单，下面说的才是使用的关键，前面只是本地用命令行使用软件，但是实际中应该是用后端语言调用这个软件。使用composer中的mikehaertl/phpwkhtmltopdf包。

1. composer安装

首先还是得安装配置环境，php的基本环境就不多说了，这里说的是安装一个包管理composer，使用composer来管理自己的php的各种包。
composer官网选择适合的版本下载安装，在命令行中输入composer --version显示版本号即安装成功

安装成功

2. 安装mikehaertl/phpwkhtmltopdf依赖

安装依赖之前最好还是改变一下composer的下载镜像路径，改为国内路径直接在命令行中输入composer config -g repo.packagist composer https://packgist.phpcomposer.com即可改变下载路径

然后cmd进入你的项目路径，输入你的命令composer require mikehaertl/phpwkhtmltopdf进行依赖的安装，等待安装成功既可，过程中可以会出现一些错误，但是优秀的你使用百度既可以解决这些问题。

3. php调用wkhtmltopdf

安装成功后过程其实就简单了，前面的安装看着简单，但是如果经验实在是不足就会导致哪里卡了半天，最少我当时就是折腾了半天的，多折腾好处多。最简单的调用就是php控制器页面写入下面的代码

use mikehaertl\wkhtmlto\Pdf;

// You can pass a filename, a HTML string, an URL or an options array to the constructor
$pdf = new Pdf('/path/to/page.html');

// On some systems you may have to set the path to the wkhtmltopdf executable
// $pdf->binary = 'C:\...';

if (!$pdf->saveAs('/path/to/page.pdf')) {
    $error = $pdf->getError();
    // ... handle error here
}

这个代码在本地调试一般是不会有问题，但是到了一些服务器就需要设置二进制路径，也就是你安装的wkhtmltopdf软件的路径，在上面打代码里面加一行$pdf->binary = 'C:\...';即可，这里是血的教训，当时一直不成功就是因为少了这一行代码，本机调试没问题，一到服务器就报错。
更加详细的使用说明可以前往github官网进行查看

三、心得总结

写这篇文章的目的一个是记录自己在学习路上遇见的难题，估计哪一天看见会有不一样的感触，另一个就是当时在查找html转化pdf的时候走了太多的歪路，网上的攻略零零散散，我踩了一个又一个坑，花了好几天的时间才最终实现了我想要的一些功能，这一切实现都不易，每次学习都会有一大堆的坑让我去踩，在坑里跳不出来的时候很痛苦，一度很想放弃，可是等到走出来的时候又是生出自豪之情,真的是让人又讨厌又享受。

----东湖小菜鸟匍匐前行之路