当前位置：首页 > news >正文

wkhtmltopdf生成图片的实践教程，包含完整的环境配置、参数解析及多语言调用示例

news 来源：原创 2025/6/9 15:16:04

欢迎来到涛涛聊AI，最近在研究HTML生成卡片的功能，一起学习下吧。

一、工具特性与安装

wkhtmltoimage是基于WebKit引擎的开源命令行工具，可将HTML网页转换为JPG/PNG等图片格式，支持CSS渲染、JavaScript执行和响应式布局。安装方式：

# Linux 
wget https://github.com/wkhtmltopdf/packaging/releases/download/0.12.6-1/wkhtmltox_0.12.6-1.bionic_amd64.deb  
sudo dpkg -i wkhtmltox_0.12.6-1.bionic_amd64.deb  
 
# Windows 
下载安装包后，将安装路径（如C:\Program Files\wkhtmltopdf\bin）加入系统PATH变量

二、基础图片生成命令

# 生成PNG图片（默认分辨率）
wkhtmltoimage https://www.baidu.com  output.png  
 
# 调整图片质量与尺寸 
wkhtmltoimage --quality 85 --width 1200 --height 900 input.html  output.jpg  
 
# 禁用JS提升生成速度 
wkhtmltoimage --disable-javascript page.html  image.png

三、高级参数配置（完整示例）

wkhtmltoimage \
--format png \          # 输出格式 
--crop-w 800 \          # 截图宽度 
--crop-h 600 \          # 截图高度 
--zoom 1.5 \            # 缩放比例 
--enable-local-file-access \  # 允许加载本地资源 
--no-images \           # 禁用图片加载 
--user-agent "Mozilla/5.0" \  # 自定义UA 
header.html  body_content.html  footer.html  combined_output.png

四、编程语言集成示例

PHP生成方案

<?php 
$url = 'https://example.com/report'; 
$outputFile = '/var/www/output/report_'.date('Ymd').'.png';
 
$command = "wkhtmltoimage --quality 90 --log-level none '$url' '$outputFile'";
exec($command, $output, $returnCode);
 
if ($returnCode === 0) {
    header('Content-Type: image/png');
    readfile($outputFile);
} else {
    echo "生成失败，错误码：$returnCode";
}

Python调用方案

import pdfkit 
 
options = {
    'format': 'png',
    'quality': 100,
    'width': 1920,
    'javascript-delay': 2000  # 等待JS执行2秒 
}
 
pdfkit.from_url( 
    'http://internal-report-system/page?id=123',
    'report_snapshot.png', 
    options=options 
)