oberonamsterdam/wkhtmltopdf

镜像概述

该镜像基于openlabs/docker-wkhtmltopdf-aas优化，使用Ubuntu 18.04系统，集成XVFB/libfontconfig以正确渲染外部字体，更新WKHTMLTOPDF至0.12.5-1版本，并升级到Python3环境，提供HTML转PDF的服务功能。

核心功能

1. 将HTML文件或内容转换为PDF格式
2. 支持通过API上传HTML文件生成PDF
3. 支持传递JSON格式的Base64编码HTML内容及配置选项生成PDF
4. 支持自定义PDF参数（如页边距、页面大小、页脚设置等）

使用场景

• 测试环境快速生成PDF文件
• 生产环境作为内部服务，为其他应用提供PDF生成能力

配置说明

• 容器暴露80端口接收API请求
• 生产环境建议仅向内部容器暴露服务，避免公网直接访问

部署示例

Docker Run（测试环境）

bash
docker run -d -p <port>:80 oberonamsterdam/wkhtmltopdf

替换<port>为本地端口（如8080）。

使用示例

curl上传HTML文件

bash
curl -X POST -vv -F 'file=@path/to/local/file.html' http://<docker-host>:<port>/ -o path/to/output/file.pdf

• <docker-host>：容器所在主机地址
• <port>：容器绑定的端口

PHP代码示例（带配置选项）

php
$options = [
    'margin-top' => '25',
    'margin-left' => '25',
    'margin-right' => '25',
    'margin-bottom' => '25',
    'page-size' => 'A4',
    'footer-spacing' => '5',
    'footer-font-size' => 6,
    'footer-right' => 'Page [page] of [topage]',
];

$html = file_get_contents('test.html');
$data = json_encode([
    'contents' => base64_encode($html),
    'options' => $options,
]);

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'http://<docker-host>:<port>',
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $data,
]);

$result = curl_exec($ch);

$result为生成的二进制PDF内容。

图片使用注意事项

1. 使用图片的绝对URL，并确保容器可访问该URL
2. 将本地图片挂载到容器内，使用本地路径引用（参考：[***]