wkhtmltopdf 遇到的坑以及填坑指南

wkhtmltopdf 遇到的坑以及填坑指南,第1张

  最近公司有一个中的需求,是将html表单转换成pdf 。

  无非方式就只有两种,前端的方式咱就不说了,您能看到这里,必然是采用了市场占有率最高的wkhtmltopdf。

  优缺点都很明显,废话不多说,直接说我踩过的坑和填过的坑。

  No1.  有登陆权限验证的页面需要打印为pdf 。如果你要打印的页面是基于权限认证的,那你打印出来,必然是跳转到认证页面的pdf。

           看到这里,不要懵逼。

          wkhtmltopdf 支持账号密码和验证码登陆,同时也支持采用cookie 的方式进行登陆。大部分时候采用cookies 登陆即可。

          具体的实现方式如下:

ProcessStartInfo psi = new ProcessStartInfo()

psi.FileName = "wkhtmltopdf.exe"

string cookieArgs = ""

var cookies = HttpContext.Current.Request.Cookies

if (cookies != null)

{

    var sb = new System.Text.StringBuilder()

    // you probably only need the ".ASPXFORMSAUTH"

    // and "ASP.NET_SessionId" cookies

    // but I pass everything just in case

    foreach (string key in cookies.AllKeys)

    {

        string value = cookies[key].Value

        sb.AppendFormat("--cookie {0} {1} ", key, value)                   

    }

    cookieArgs = sb.ToString()

}

psi.Arguments = urlToPrint + " -q " + cookieArgs + " -"

Process.Start(psi)

 No2.打印的内容不全。 

这时候要分析具体原因,在wkhtmltopdf 里有一个参数是--window-status ,这个参数可以支持ajax异步请求 的。

做法是: 在调用wkhtmltopdf 时,传入参数 ,比如 传入 “   --window-status  completed”   ,然后在ajax 完成回调时 ,也将document 的window.status = "completed",这样的话,就会完全支持异步调用。有两点需要注意:1.每个参数之间必须有空格,不然一定会出现你想到的问题。2.window.status 的值必须与传入的参数值一样,否则的话,就会一直处于等待状态。

No3. 空白页面,网页显示完好无损,但打印出来的却是空白页面。      

     这是最大的一个坑,我研究了一天才踩平了。到现在还有一些疑问的地方,等到时候我在去重新踩 。说一下坑在哪里哈.

      wkhtmltopdf 的工具是基于qt webkit 的。所以基本上目前的流行玩法都是支持的。但特么的也有例外,由于官网已经很久没有更新,我去github上看到的更新也是很久之前的。

     如果是普通的mvc 和html 页面是完全没有问题的。但单页面应用程序的坑就大了。

    我当时用的版本是angular js ,在页面显示完美,但在pdf 打印出来确实空白的。

     起初我认为问题出现在wkhtmltopdf ,它并不支持单页面应用程序。但我用vue 测试的没有问题。于是我重新测试angular js ,我在github 看了每一个提问者的问题。发现一个提问者讲到,他用的angular js  1.4的版本出现了问题,回撤到1.3.5 则正常。于是我发现新大陆一样,将angular js 的版本也回车到了1.3.5 ,发现打印出来的页面不在是空白页面,是有内容的页面。由于我头一次接触angluar js ,我问同事才得知,angluar js 1.4版本跨度比较大,改变了好多的内容,包括请求方式都发生了很大的变化。这也就解释了,为啥使用angular js 打印的是空白页,因为angular js 1.4以上的版本,你用wkhtmltopdf 根本就调用不到后台的内容,压根就不会发起请求。

      别急,到这里,坑还没结束,虽然能请求后端了,但是我发现,打印出来的内容却缺少了很多东西,这时候就尴尬了,angular js 1.4 以上的 渲染的内容没有问题,但不能向后台发起请求,angular js 1.3.5能发起请求,但问题是打印的时候渲染不出内容。 经过我和同事的一步步调试,发现问题竟然在css ,一个叫overflow 的标签直接影响内容。 具体详情请参考前辈的: https://www.jianshu.com/p/57c897cfaa27

    周六折腾了一天,总算是搞定了。希望对大家能有所帮助,如果有什么问题,大家及时留言。我会尽快的帮助大家解决。

安装wkhtmltopdf

# apt-get install wkhtmltopdf

从HTML生成PDF文件的基本语法如下:

# wkhtmltopdf input-file output-file

我们可以从任何网页生成PDF:

# wkhtmltopdf example.com example.pdf

或从本地html文件:

# wkhtmltopdf example.html example.pdf

以上命令只能在Linux box 图形环境中使用。如果我们在一个VPS或专用服务器上生成PDF,如果我们执行该命令,我们将得到从下错误:

wkhtmltopdf: cannot connect to X server

为了解决这个问题,我们需要使用一个名为 xvfb 的工具。

Xvfb是一个 X 服务器,能够运行在没有显示硬件和没有物理输入设备的机器上。它使用虚拟内存来模拟一个dumb framebuffer。

回到顶部

安装 xvfb

# apt-get install xvfb

接下来,我们需要创建一个shell脚本:

xvfb-run --server-args="-screen 0, 1024x768x24" /usr/bin/wkhtmltopdf $*

然后将它保存在 /usr/bin/wkhtmltopdf.sh 下

下一步,我们将创建一个 symbolic 链接,这样我们就可以执行脚本而不用编写的完整路径:

# ln -s /usr/bin/wkhtmltopdf.sh /usr/local/bin/wkhtmltopdf2

让我们尝试执行shell脚本,并看看会发生什么。

# wkhtmltopdf2 example.com example.pdf

Loading page (1/2)

Printing pages (2/2)

Done

好,如果能够正确运行。就可以用以下自定义PHP脚本来生成一个PDF文件。

//Turn on output buffering

ob_start()

echo "<html>"

echo "<head>"

echo "<link href='http://example.com/style.css' rel='stylesheet' type='text/css'>"

echo "</head>"

你试试吧,我还要在后盾网学习呢,有不会的可以问我


欢迎分享,转载请注明来源:夏雨云

原文地址:https://www.xiayuyun.com/zonghe/28312.html

(0)
打赏 微信扫一扫微信扫一扫 支付宝扫一扫支付宝扫一扫
上一篇 2023-02-18
下一篇2023-02-18

发表评论

登录后才能评论

评论列表(0条)

    保存