wkhtmltox 生成 pdf 或 image 文件

隔壁小白

已于 2022-04-03 21:40:59 修改

阅读量709

点赞数

CC 4.0 BY-SA版权

分类专栏： php wkhtmltox 文章标签： linux centos php 后端 wkhtmltopdf

于 2022-04-03 20:55:16 首次发布

本文链接：https://blog.csdn.net/cbaln0/article/details/123944102

php 同时被 2 个专栏收录

18 篇文章

订阅专栏

wkhtmltox

1 篇文章

订阅专栏

本文档详细介绍了如何在CentOS7系统上安装wkhtmltopdf，包括下载匹配系统版本的rpm或tar.xz文件，解压安装过程，解决依赖问题，以及在PHP环境中使用wkhtmltopdf生成PDF。此外，还讨论了解决PDF中文乱码的方法，提供了一段PHP代码示例来动态生成PDF。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、根据自己系统版本下载对应版本

 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 下面就行