资源

https://github.com/subtlephp/phpwkhtmltox/blob/master/src/WkHtmlTo/PDF/ConfigResolver.php
https://wkhtmltopdf.org/usage/wkhtmltopdf.txt

  1. 名称：
  2.   wkhtmltopdf 0.12.5（补丁qt）
  4. 概要：
  5.   wkhtmltopdf [GLOBAL OPTION] ... [OBJECT] ... <输出文件>
  7. 文件对象：
  8.   wkhtmltopdf能够将多个对象放入输出文件中，对象是
  9.   单个网页，封面网页或目录。对象
  10.   按照在指定的顺序放入输出文档
  11.   命令行，可以基于每个对象或全局指定选项
  12.   选择区。“全局选项”部分中的选项只能放入
  13.   全球选择领域
  15.   页面对象将单个网页的内容放入输出文档中。
  17.   （页）？<输入网址/文件名> [页面选项] ...
  18.   页面对象的选项可以放在全局选项和页面中
  19.   选择领域。适用的选项可在页面选项和页面中找到
  20.   页眉和页脚选项部分。
  22.   封面对象将单个网页的内容放入输出文档中，
  23.   页面没有出现在目录中，也没有标题
  24.   和页脚。
  26.   封面<输入网址/文件名> [页面选项] ...
  27.   还可以为页面对象指定所有可以选择的选项
  28.   封面。
  30.   目录对象将内容表插入到输出中
  31.   文献。
  33.   toc [TOC选项] ......
  34.   还可以为页面对象指定所有可以选择的选项
  35.   另外，TOC选项部分的选项也可以更多
  36.   应用。目录是通过XSLT生成的，这意味着它可以
  37.   被设计为看起来你想要它看起来。想知道该怎么做
  38.   这可以通过提供来转储默认的xslt文档
  39.   --dump-default-toc-xsl，以及它提供的工作大纲
  40.   --dump-outline，请参阅“大纲选项”部分。
  42. 描述：
  43.   使用wkhtmltopdf patched将一个或多个HTML页面转换为PDF文档
  44.   QT。
  46. 全球选择：
  47.       - 打印多份时，逐份打印
  48.                                       （默认）
  49.       --no-collate打印多个时不进行整理
  50.                                       副本
  51.       --cookie-jar <path>读取和写入cookie
  52.                                       提供的cookie jar文件
  53.       --copies <number>要打印到pdf中的份数
  54.                                       文件（默认1）
  55.   -d， -  dpi <dpi>显式更改dpi（这没有
  56.                                       对基于X11的系统的影响）（默认为96）
  57.   -H， -  extended-help显示更广泛的帮助，详细说明
  58.                                       不太常见的命令开关
  59.   -g， -  grayscale PDF将以灰度生成
  60.   -h， -  help显示帮助
  61.       --htmldoc输出程序html帮助
  62.       --image-dpi <integer>当嵌入图像时将它们缩小到
  63.                                       这个dpi（默认为600）
  64.       --image-quality <integer>当jpeg压缩图像时使用它
  65.                                       质量（默认94）
  66.       --license输出许可证信息并退出
  67.       --log-level <level>将日志级别设置为：none，error，warn或
  68.                                       信息（默认信息）
  69.   -l， -  lowquality生成较低质量的pdf / ps。有用的
  70.                                       缩小结果文档空间
  71.       --manpage输出程序手册页
  72.   -B， -  margin-bottom <unitreal>设置页面底部边距
  73.   -L， -  margin-left <unitreal>设置页面左边距（默认为10mm）
  74.   -R， -  margin-right <unitreal>设置页面右边距（默认为10mm）
  75.   -T， -  margin-top <unitreal>设置页面上边距
  76.   -O， - 方向<orientation>将方向设置为横向或纵向
  77.                                       （默认人像）
  78.       --page-height <unitreal>页面高度
  79.   -s， -  page-size <尺寸>将纸张尺寸设置为：A4，Letter等
  80.                                       （默认A4）
  81.       --page-width <unitreal>页面宽度
  82.       --no-pdf-compression不要在pdf上使用无损压缩
  83.                                       对象
  84.   -q， -  quiet更加冗长，为倒退而维护
  85.                                       兼容性; 与使用--log-level相同
  86.                                       没有
  87.       --read-args-from-stdin从stdin读取命令行参数
  88.       --readme输出程序自述文件
  89.       --title <text>生成的pdf文件的标题（The
  90.                                       如果没有，则使用第一个文档的标题
  91.                                       指定）
  92.       --use-xserver使用X服务器（一些插件和其他插件）
  93.                                       没有X11可能无法正常工作
  94.   -V， -  version输出版本信息并退出
  96. 大纲选项：
  97.       --dump-default-toc-xsl将默认的TOC xsl样式表转储到
  98.                                       标准输出
  99.       --dump-outline <file>将大纲转储到文件中
  100.       --outline将大纲放入pdf（默认）
  101.       --no-outline不要在pdf中加入大纲
  102.       --outline-depth <level>设置轮廓的深度（默认为4）
  104. 页面选项：
  105.       --allow <path>允许指定的文件
  106.                                       要加载的文件夹（可重复）
  107.       --background打印背景（默认）
  108.       --no-background不打印背景
  109.       --bypass-proxy-for <value>绕过主机代理（可重复）
  110.       --cache-dir <path> Web缓存目录
  111.       --checkbox-checked-svg <path>选中渲染时使用此SVG文件
  112.                                       复选框
  113.       --checkbox-svg <path>在未选中呈现时使用此SVG文件
  114.                                       复选框
  115.       --cookie <name> <value>设置一个额外的cookie（可重复），
  116.                                       值应该是url编码的。
  117.       --custom-header <name> <value>设置一个额外的HTTP头（可重复）
  118.       --custom-header-propagation添加指定的HTTP头
  119.                                       - 每个资源请求的自定义标头。
  120.       --no-custom-header-propagation不添加指定的HTTP头
  121.                                       - 每个资源请求的自定义标头。
  122.       --debug -javascript显示javascript调试输出
  123.       --no-debug-javascript不显示javascript调试输出
  124.                                       （默认）
  125.       --default-header添加一个默认标题，其名称为
  126.                                       页面左侧，页码到
  127.                                       右边，这是：
  128.                                       --header左= '[网页]'
  129.                                       --header-right ='[page] / [toPage]' -  top 2cm
  130.                                       --header线
  131.       --encoding <encoding>设置输入的默认文本编码
  132.       --disable-external-links不要链接到远程网页
  133.       --enable-external-links建立到远程网页的链接（默认）
  134.       --disable-forms不要将HTML表单字段转换为pdf格式
  135.                                       字段（默认）
  136.       --enable-forms将HTML表单字段转换为pdf表单字段
  137.       --images加载或打印图像（默认）
  138.       --no-images不加载或打印图像
  139.       --disable-internal-links不要建立本地链接
  140.       --enable-internal-links制作本地链接（默认）
  141.   -n， -  disable-javascript不允许网页运行javascript
  142.       --enable-javascript允许网页运行javascript
  143.                                       （默认）
  144.       --javascript-delay <msec>等待几毫秒的javascript
  145.                                       完成（默认200）
  146.       --keep-relative-links将相对外部链接保持为相对
  147.                                       外部链接
  148.       --load-error-handling <handler>指定如何处理失败的页面
  149.                                       load：abort，ignore或skip（默认值
  150.                                       中止）
  151.       --load-media-error-handling <handler>指定如何处理媒体文件
  152.                                       无法加载：中止，忽略或跳过
  153.                                       （默认忽略）
  154.       --disable-local-file-access不允许转换本地文件
  155.                                       读取其他本地文件，除非
  156.                                       明确允许使用--allow
  157.       --enable-local-file-access允许将本地文件转换为read
  158.                                       在其他本地文件中。（默认）
  159.       --minimum-font-size <int>最小字体大小
  160.       --exclude-from-outline不要在表格中包含该页面
  161.                                       内容和大纲
  162.       --include-in-outline在目录中包含该页面
  163.                                       和轮廓（默认）
  164.       --page-offset <offset>设置起始页码（默认为0）
  165.       --password <密码> HTTP验证密码
  166.       --disable-plugins禁用已安装的插件（默认）
  167.       --enable-plugins启用已安装的插件（插件将
  168.                                       可能不起作用）
  169.       --post <name> <value>添加额外的帖子字段（可重复）
  170.       --post-file <name> <path>发布一个附加文件（可重复）
  171.       --print-media-type使用print media-type而不是screen
  172.       --no-print-media-type不要使用打印介质类型而不是
  173.                                       屏幕（默认）
  174.   -p， -  proxy <proxy>使用代理
  175.       --proxy-hostname-lookup使用代理解析主机名
  176.       --radiobutton-checked-svg <path>选中渲染时使用此SVG文件
  177.                                       单选按钮
  178.       --radiobutton-svg <path>在未选中渲染时使用此SVG文件
  179.                                       单选按钮
  180.       --resolve-relative-links将相对外部链接解析为
  181.                                       绝对链接（默认）
  182.       --run-script <js>运行此附加的javascript后
  183.                                       页面加载完成（可重复）
  184.       --disable-smart-shrinking禁用智能收缩策略
  185.                                       由WebKit用来制作像素/ dpi
  186.                                       比率无常数
  187.       --enable-smart-shrinking启用智能收缩策略
  188.                                       由WebKit用来制作像素/ dpi
  189.                                       比率无常数（默认）
  190.       --ssl-crt-path <path> ssl客户端证书公钥的路径
  191.                                       OpenSSL PEM格式，可选择后跟
  192.                                       中级ca和可信证书
  193.       --ssl-key-password <密码> ssl客户端证书私钥的密码
  194.       --ssl-key-path <path> ssl客户端证书私钥的路径
  195.                                       OpenSSL PEM格式
  196.       --stop-slow-scripts停止慢速运行javascripts（默认）
  197.       --no-stop-slow-scripts不要停止慢速运行javascripts
  198.       --disable-toc-back-links不要从节头到toc链接
  199.                                       （默认）
  200.       --enable-toc-back-links从节头到toc的链接
  201.       --user-style-sheet <url>指定要加载的用户样式表
  202.                                       每一页
  203.       --username <username> HTTP身份验证用户名
  204.       --viewport-size <>如果您有自定义，则设置视口大小
  205.                                       滚动条或css属性溢出到
  206.                                       模拟窗口大小
  207.       --window-status <windowStatus>等到window.status等于this
  208.                                       渲染页面前的字符串
  209.       --zoom <float>使用此缩放系数（默认值为1）
  211. 页眉和页脚选项：
  212.       --footer-center <text>居中的页脚文字
  213.       --footer-font-name <name>设置页脚字体名称（默认Arial）
  214.       --footer-font-size <size>设置页脚字体大小（默认为12）
  215.       --footer -html <url>添加一个html页脚
  216.       --footer-left <text>左对齐的页脚文本
  217.       -  footer-line页脚上方的显示行
  218.       --no-footer-line不要在页脚上方显示行
  219.                                       （默认）
  220.       --footer-right <text>右对齐的页脚文本
  221.       --footer-spacing <real>页脚和内容之间的间距，单位为mm
  222.                                       （默认为0）
  223.       --header-center <text>居中的标题文本
  224.       --header-font-name <name>设置标题字体名称（默认Arial）
  225.       --header-font-size <size>设置标题字体大小（默认为12）
  226.       --header-html <url>添加一个html标题
  227.       --header-left <text>左对齐标题文本
  228.       --header-line标题下方的显示行
  229.       --no-header-line不在标题下方显示行
  230.                                       （默认）
  231.       --header-right <text>右对齐标题文本
  232.       --header-spacing <real>标题和内容之间的间距，单位为mm
  233.                                       （默认为0）
  234.       --replace <name> <value>将[name]替换为header和中的值
  235.                                       页脚（可重复）
  237. TOC选项：
  238.       --disable-dotted-lines不要在toc中使用虚线
  239.       --toc-header-text <text> toc的标题文本（默认表
  240.                                       内容）
  241.       --toc-level-indentation <width>对于toc中的每个标题级别
  242.                                       按此长度缩进（默认为1em）
  243.       --disable-toc-links不要从toc链接到部分
  244.       --toc-text-size-shrink <real>对于toc中每个级别的标题
  245.                                       字体按此因子缩放（默认值
  246.                                       0.8）
  247.       --xsl-style-sheet <file>使用提供的xsl样式表
  248.                                       打印目录
  250. 页面大小：
  251.   渲染文档的默认页面大小为A4，但使用此方法
  252.   --page-size选项可以改为几乎任何其他选项，例如：A3，
  253.   信和法律。有关支持的页面大小的完整列表，请参阅
  254.   <http://qt-project.org/doc/qt-4.8/qprinter.html#PaperSize-enum>。
  256.   对于页面大小更精细的控制--page-height和
  257.   - 可以使用 - 页面宽度选项
  259. 从stdin读取参数：
  260.   如果您需要批量转换大量页面，并且您感觉如此
  261.   wkhtmltopdf启动有点太慢，那你应该试试
  262.   --read-ARGS从 - 标准输入，
  264.   当--read-args-from-stdin将每行输入发送到stdin上的wkhtmltopdf时
  265.   将作为wkhtmltopdf的单独调用，并指定参数
  266.   在给定的行上结合给wkhtmltopdf的参数
  268.   例如，可以执行以下操作：
  270.   echo“http://qt-project.org/doc/qt-4.8/qapplication.html qapplication.pdf”>> cmds
  271.   echo“cover google.com http://en.wikipedia.org/wiki/Qt_(software)qt.pdf”>> cmds
  272.   wkhtmltopdf --read-args-from-stdin --book <cmds
  274. 指定代理：
  275.   默认情况下，将从环境变量中读取代理信息：
  276.   proxy，all_proxy和http_proxy，代理选项也可以通过指定
  277.   -p开关
  279.   <type>：=“http：//”| “SOCKS5：//”
  280.   <serif>：= <username>（“：”<password>）？“@”
  281.   <proxy>：=“无”| <类型>？<字符串>？<host>（“：”<port>）？
  283.   以下是一些示例（如果您不熟悉BNF）：
  285.   HTTP：//用户名：密码@ myproxyserver：8080
  286.   SOCKS5：// myproxyserver
  287.   没有
  289. 页脚和标题：
  290.   页眉和页脚可以通过--header- *和添加到文档中
  291.   - 恭敬地参与*争论。在提供的页眉和页脚文本字符串中
  292.   例如--header-left，将替换以下变量。
  294.    * [页面]替换为当前正在打印的页数
  295.    * [frompage]替换为要打印的第一页的编号
  296.    * [topage]替换为要打印的最后一页的编号
  297.    * [网页]替换为正在打印的页面的URL
  298.    * [section]替换为当前部分的名称
  299.    * [subsection]替换为当前小节的名称
  300.    * [date]以系统本地格式替换为当前日期
  301.    * [isodate]替换为ISO 8601扩展格式的当前日期
  302.    * [time]以系统本地格式替换当前时间
  303.    * [title]替换为当前页面对象的标题
  304.    * [doctitle]替换为输出文档的标题
  305.    * [sitepage]替换为当前正在转换的网站中的页面编号
  306.    * [sitepages]替换为当前正在转换的网站中的页数
  309.   作为一个例子，将指定--header-right“[toPage]”的Page [page]
  310.   在文本“Page x of y”中，其中x是当前页面的编号，y是
  311.   最后一页的编号，显示在左上角
  312.   文献。
  314.   页眉和页脚也可以提供HTML文档。举个例子
  315.   可以指定--header-html header.html，并使用以下内容
  316.   header.html中：
  318.   <！DOCTYPE html>
  319.   <HTML> <HEAD> <SCRIPT>
  320.   function subst（）{
  321.       var vars = {};
  322.       var query_strings_from_url = document.location.search.substring（1）.split（'＆'）;
  323.       for（query_strings_from_url中的var query_string）{
  324.           if（query_strings_from_url.hasOwnProperty（query_string））{
  325.               var temp_var = query_strings_from_url [query_string] .split（'='，2）;
  326.               vars [temp_var [0]] = decodeURI（temp_var [1]）;
  327.           }
  328.       }
  329.       var css_selector_classes = ['page'，'frompage'，'topage'，'pagepage'，'section'，'subsection'，'date'，'isodate'，'time'，'title'，'doctitle'，'sitepage '，'sitepages'];
  330.       for（（css_selector_classes中的var css_class）{
  331.           if（css_selector_classes.hasOwnProperty（css_class））{
  332.               var element = document.getElementsByClassName（css_selector_classes [css_class]）;
  333.               for（var j = 0; j <element.length; ++ j）{
  334.                   element [j] .textContent = vars [css_selector_classes [css_class]];
  335.               }
  336.           }
  337.       }
  338.   }
  339.   </ script> </ head> <body style =“border：0; margin：0;” 的onload = “SUBST（）”>
  340.   <table style =“border-bottom：1px solid black; width：100％”>
  341.     <TR>
  342.       <td class =“section”> </ td>
  343.       <td style =“text-align：right”>
  344.         <span class =“topage”> </ span>的页面<span class =“page”> </ span>
  345.       </ TD>
  346.     </ TR>
  347.   </ TABLE>
  348.   </ BODY> </ HTML>
  351.   从示例中可以看出，参数被发送到页眉/页脚
  352.   获得时尚的html文档。
  354. 大纲：
  355.   带有补丁qt的Wkhtmltopdf支持PDF轮廓，也称为书
  356.   标记，可以通过指定--outline开关来启用。大纲
  357.   是基于<h？>标签生成的，用于深入描述如何
  358.   完成后参见目录部分。
  360.   如果<h？>标签传播到，那么大纲树有时可能非常深
  361.   在HTML文档中慷慨。--outline-depth开关可用于
  362.   限制了这个。
  364. 目录：
  365.   通过向toc对象添加toc对象，可以将目录添加到文档中
  366.   命令行。例如：
  368.   wkhtmltopdf toc http://qt-project.org/doc/qt-4.8/qstring.html qstring.pdf
  370.   基于输入文档中的H标签生成目录。
  371.   首先生成XML文档，然后使用XSLT将其转换为HTML。
  373.   生成的XML文档可以通过使用它将其转储到文件来查看
  374.   --dump-outline开关。例如：
  376.   wkhtmltopdf --dump-outline toc.xml http://qt-project.org/doc/qt-4.8/qstring.html qstring.pdf
  378.   可以使用--xsl-style-sheet开关指定XSLT文档。对于
  379.   例：
  381.   wkhtmltopdf toc --xsl-style-sheet my.xsl http://qt-project.org/doc/qt-4.8/qstring.html qstring.pdf
  383.   --dump-default-toc-xsl开关可用于转储默认的XSLT样式
  384.   表格到标准输出。这是编写自己的样式表的良好开端
  386.   wkhtmltopdf --dump-default-toc-xsl
  387.   XML文档位于命名空间“http://wkhtmltopdf.org/outline”中
  388.   称为“outline”的根节点，其中包含许多“item”节点。一个物品
  389.   可以包含任意数量的项目。这些是大纲的子部分
  390.   该项代表的部分。项目节点具有以下属性：
  392.  *“标题”该部分的名称。
  393.  *“page”该部分出现的页码。
  394.  *“链接”链接到该部分的URL。
  395.  *“backLink”该部分将链接回的锚点的名称。
  397.   剩余的TOC选项仅影响默认样式表，因此它们不会
  398.   指定自定义样式表时工作。
  400. 联系：
  401.   如果您遇到错误或想要请求新功能，请访问
  402.   <https://github.com/wkhtmltopdf/wkhtmltopdf/issues>

安装包 wkhtmltopdf

PHP html 转换成PDF wkhtmltopdf HTML 转换成 PDF (JAVA C#都适用)


https://blog.csdn.net/fenglailea/article/details/77650652

因为涉及到账单，并且要生成PDF并发送邮件，所以试用了好多转换PDF的都不成功，基本上都是格式错乱，唯一就是 wkhtmltopdf 满足 我的需求
https://wkhtmltopdf.org/downloads.html

  1. 这里下载是 linux 64
  2. 安装环境
  3. CENTOS 7.3
  5. 下载及安装
  6. wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz
  10. tar -Jxv -f **.tar.xz
  11. 或者
  13. xz -d **.tar.xz
  14. tar -xv -f **.tar
  16. 移动文件目录到相关位置,例如 移动文件夹到/www/lanmps/目录下
  17. mv wkhtmltox /www/lanmps/wkhtmltox
  19. 建立软连接,
  20. ln -s /www/lanmps/wkhtmltox/wkhtmltoimage /usr/local/bin/wkhtmltoimage          #转换成图片
  21. ln -s /www/lanmps/wkhtmltox/bin/wkhtmltopdf /usr/local/bin/wkhtmltopdf          #转换成 PDF
  24. PHP 中使用 shell_exec 执行
  25. shell_exec("wkhtmltopdf http://www.lanmps.com lanmps.com.pdf")
  27. shell 中执行
  28. wkhtmltopdf http://www.lanmps.com lanmps.com.pdf
  30. 中文字体
  31. 服务器上必须安装字体
  32. http://blog.csdn.net/wlwlwlwl015/article/details/51482065
  34. 新建字体目录
  35. /usr/share/fonts/chinese
  36. chmod -R 755 /usr/share/fonts/chinese
  38. 上传字体宋体，你自己电脑中的字体，或者网上下载的也可以，字体如下
  39. simsun.ttc   # 宋体 http://down7.pc6.com/qd3/simsun.zip 记得解压缩
  40. simsun.ttf
  43. 接下来需要安装ttmkfdir来搜索目录中所有的字体信息，并汇总生成fonts.scale文件，输入命令：
  44. yum -y install ttmkfdir
  47. 然后执行ttmkfdir命令即可：
  48. ttmkfdir -e /usr/share/X11/fonts/encodings/encodings.dir
  50. 最后一步就是修改字体配置文件了，首先通过编辑器打开配置文件：
  51. vim /etc/fonts/fonts.conf
  53. 可以看到一个Font list，即字体列表，在这里需要把我们添加的中文字体位置加进去：加入到类似的位置
  54. <dir>/usr/share/fonts/chinese</dir>
  57. 然后输入:wq保存退出，最后别忘了刷新内存中的字体缓存，这样就不用reboot重启了：
  58. 字体缓存
  59. fc-cache
  62. 查看字体
  63. fc-list |grep SimSun
  65. 可以看到已经成功安装上了中文字体，
  66. 中文编码解决
  67. http://aiilive.blog.51cto.com/1925756/1340243/
  70. error while loading shared libraries: libXrender.so.1: 
  71. cannot open shared object file: No such file or directory
  72. ./bin/wkhtmltopdf: error while loading shared libraries:
  73. libXrender.so.1: cannot open shared object file: No such file or directory
  76. 解决方法：
  77. yum install -y libXrender