一、根据自己系统版本下载对应版本
lsb_release -a 我的是 CentOS 7.5 ,所以下载 CentOS 7 x86_64 / i686 Package (.rpm) built on CentOS 7.4.1804 https://downloads.wkhtmltopdf.org/0.12/0.12.5/wkhtmltox-0.12.5-1.centos7.x86_64.rpm //rpm文件 但是如果你想用tar.xz文件,下载地址在 https://github.com/wkhtmltopdf/wkhtmltopdf/releases/0.12.4 选择对应操作系统即可,我选择的是 https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz
二、解压、安装
由于上面我们分了两种文件,下面我们介绍两种安装方式:
不管哪种方式,我们需要先进入到安装的目录,进入shell命令:
cd / #进入根目录
cd usr/local #进入指定目录
【1】rpm文件安装
进入指定目录后执行下面命令 :
这里按章rpm文件,遇到了很多需要下载的包,所以我尝试换一下tar.xz文件下载
【2】tar.xz文件下载安装
命令:
$ : wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz #下载文件
$ : tar -xvf wkhtmltox-0.12.4_linux-generic-amd64.tar.xz #解压文件
在usr/local 出现 wkhtmltox 文件夹即为成功
为了能从任意路径执行程序,将 wkhtmltopdf 安装到 /usr/bin 目录下 ,执行命令
$ : cp wkhtmltox/bin/wkhtmltopdf /usr/bin/
三、遇到的问题
本人中途遇到了很多报错问题 fontconfig is needed by wkhtmltox-1:0.12.5-1.centos7.x86_64 libXext is needed by wkhtmltox-1:0.12.5-1.centos7.x86_64 libXrender is needed by wkhtmltox-1:0.12.5-1.centos7.x86_64 xorg-x11-fonts-75dpi is needed by wkhtmltox-1:0.12.5-1.centos7.x86_64 xorg-x11-fonts-Type1 is needed by wkhtmltox-1:0.12.5-1.centos7.x86_64 上面的提示,我缺少 fontconfig libXext libXrender,于是我按照缺少的一直用 yum安装(操作系统里面没有yum可自行百度安装方法) 下面是我安装的一些插件: $ : yum install libXrender* $ : yum install libfontconfig* $ : yum install libXext*
四、使用wkhtmltopdf
如果你没有碰到我第三部的问题,可以直接再shell控制台直接使用 $ : wkhtmltopdf http://www.baidu.com pdftest.pdf 成功显示 Loading pages (1/6) libpng warning: iCCP: known incorrect sRGB profile ] 49% libpng warning: iCCP: known incorrect sRGB profile ] 53% libpng warning: iCCP: known incorrect sRGB profile ] 56% Counting pages (2/6) Resolving links (4/6) Loading headers and footers (5/6) Printing pages (6/6) Done 如果你不知道生成的pdf路径在哪里 ,我们需要查找刚才生成的pdf文件 $ :find / -name pdftest.pdf 输出 /usr/local/pdftest.pdf ,可以看到生成的pdf文件默认在 wkhtmltox 同级目录下
五、在php下使用 wkhtmltopdf
刚才是在控制台使用的wkhtmltopdf命令,而我们需要在php文件执行生成pdf,总结网上给的方法: (1)安装libwkhtmltox (linux内核、Centos-6 .5-64bit),相当于一个扩展 (2)shell_exec() 执行shell命令,确保该函数可以执行 我这里最开始碰到的一个问题是,在在服务器控制台用wkhtmltopdf http://www.baidu.com pdftest.pdf可以 生成pdf文件,用自己的php代码生成一直行不通,以为是扩展和shellexec必须要同时满足,其实只要满足其中 一个就行,用shellexec快一点,用第一种方法需要×××下载或者git查找需要的扩展压缩。* 【1】这里我要实现的是 前端给一个地址访问 http://www.xxx.com/test/test,生成对应的pdf文件在服务器端口, 于是简单的给一个可以访问的地址生成test.php文件 php代码 : 运行 http://www.xxx.com/test/test ,但是一直没有执行生成对应的pdf 【2】我尝试另外的解决方式 我在 /usr/local下生成 test.php文件 代码如上,用服务端自己运行 $ : php test.php 竟然在 /usr/local 下生成了make.pdf 【3】但是为什么放在可访问的地址上写一样的代码,第二种方法可以生成,于是我在第一种test.php 改写代码
<? php $res = shell_exec('wkhtmltopdf -V); #注意这里是 大写的 V ?>
可以看到浏览器里面返回了
<?php $res = shell_exec('wkhtmltopdf http://www.baidu.com make.pdf'); ?>
wkhtmltopdf 0.12.4 (with patched qt) 【4】对比两种方法,说明wkhtmltopdf是可以执行了,因为可以返回其中的版本,只是为什么一个可以生成一 个不可以,最后发现是你进入shell是以root身份进去,有着读写命令, 但是直接访问你地址的话,你写入pdf没 有这个权限 需要赋予这个权限,你可以在你的项目里面给与一个有权限的,我生成的是 /app/pdf 所以test.php代码改进,直接访问 http://www.xxx.com/test/test
<?php $name = 'test.pdf'; $url = 'http://www.baidu.com'; $file = '/usr/local/nginx/html/xiaohua/App/pdf/'.$name; $res = shell_exec('wkhtmltopdf '.$url.' '.$file); ?>
第二个根据所传的url 和输出pdf名称,进行浏览器下载pdf, 访问: http://www.xxx.com/test/test?url=http://www.baidu.com&name=test.pdf
<?php $url = $_GET['url']; $name = $_GET['name']; $file = '/usr/local/nginx/html/xiaohua/App/pdf/'.$name; $res = shell_exec('wkhtmltopdf '.$url.' '.$file); header('Content-type: application/pdf'); header('Content-Disposition: attachment; filename='.$name ); readfile( $file); ?>
六、生成pdf中文乱码问题
可以看到你通过访问 http://www.xxx.com/test/test?url=http://www.baidu.com&name=test.pdf 生成的pdf文件,
存在中文乱码问题,可以在自己 C:\Windows\Fonts 找到 simsun.ttc 中文宋体,simsun.ttc 而不是 simsun.ttf,
把字体文件放在 放在 /usr/share/fonts/chinese/TrueType 下面就行