wkhtmltox\PDF\Converter::convert()

将HTML内容转换为PDF格式

首字母:W

函数名称:wkhtmltox\PDF\Converter::convert()

适用版本:wkhtmltox 0.12.4

函数用法:该函数用于将HTML内容转换为PDF格式。它是wkhtmltopdf库的一部分,可以在PHP中使用。

语法:

public static function convert($html, $options = [], $outputFile = '')

参数:

  • $html(必需):要转换为PDF的HTML内容。
  • $options(可选):转换选项的数组。默认为空数组。可以使用各种选项来自定义转换过程,如页面大小、页边距、页眉页脚等。
  • $outputFile(可选):输出PDF文件的路径。默认为空字符串。如果未指定输出文件路径,则函数将返回PDF内容作为字符串。

返回值:

  • 如果指定了$outputFile参数,则返回true表示转换成功,否则返回PDF内容的字符串。

示例:

use wkhtmltox\PDF\Converter;
$html = '

Hello, World!

'; $outputFile = '/path/to/output.pdf'; $options = [ 'page-size' => 'A4', 'margin-top' => '10mm', 'margin-right' => '10mm', 'margin-bottom' => '10mm', 'margin-left' => '10mm', ]; // 将HTML内容转换为PDF并保存到指定路径 if (Converter::convert($html, $options, $outputFile)) { echo 'PDF转换成功!'; } else { echo 'PDF转换失败!'; } // 将HTML内容转换为PDF并获取PDF内容作为字符串 $pdfContent = Converter::convert($html, $options); echo $pdfContent;

注意事项:

  • 在使用该函数之前,需要先安装wkhtmltopdf库,并确保其可执行文件(wkhtmltopdf)位于系统的可执行路径中。
  • 可以通过$options参数来自定义转换过程,具体的选项可以参考wkhtmltopdf的官方文档。
  • 如果转换失败,可以通过查看返回的错误信息来进行故障排除。
  • 转换过程可能会消耗较多的系统资源,特别是对于复杂的HTML内容,建议在服务器端进行转换时注意性能优化。

同首字母函数