Docker微服务之Html转Pdf,Html转Image

2017-08-30 本文已影响395人 biaoqianwo

Html转Pdf(Image)的方案应该很多，这里介绍的是docker的一个微服务的方式，利用了工具wkhtmltopdf。

一、Docker微服务

Docker微服务首先是一种服务，暴露一个接口给使用者（一个application），使用者通过端口请求并获得服务。

首先，创建一个镜像，一般是自建Dockerfile，用 docker build -t serverImageName -f Dockerfile .
或者使用他人的镜像docker pull serverImageName。
其次，运行一个容器作为服务，常用docker run -d --name serverContainerName -p hostPort:DockerPort serverImageName:version（':version'可以省略，默认是latest版本）。
调用
- 应用容器，docker run --link serverContainerName:alias applicationImageName.容器的数据通信通过参数--link解决。
- PHP程序调用：get('alias:hostPort'),可以用php-curl-class等。
- 其他调用，比如浏览器调用nginx（httpd）。

推荐阅读：搭建LNMP环境，加深对docker的了解.（在本教程中，mysql就是一个微服务供php7通过参数link的当时调用，php7是个微服务被nginx通过参数link调用，nginx是个微服务，被浏览器调用）
我一直觉得最好的教程还是官方教程，不懂的用有道等翻译，英语慢慢学。

二、工具wkhtmltopdf、wkhtmltoimage

官网 https://wkhtmltopdf.org/

介绍

wkhtmltopdf and wkhtmltoimage are open source (LGPLv3) command line tools to render HTML into PDF and various image formats using the Qt WebKit rendering engine. These run entirely "headless" and do not require a display or display service.

linux上的安装

cd /tmp
wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz
tar xf wkhtmltox-0.12.4_linux-generic-amd64.tar.xz && rm wkhtmltox-0.12.4_linux-generic-amd64.tar.xz
ln -s -T /tmp/wkhtmltox/bin/wkhtmltopdf /usr/local/bin/wkhtmltopdf && \
chmod a+x /usr/local/bin/wkhtmltopdf &&  \
ln -s -T /tmp/wkhtmltox/bin/wkhtmltoimage /usr/local/bin/wkhtmltoimage && \
chmod a+x /usr/local/bin/wkhtmltoimage

使用

wkhtmltopdf http://google.com google.pdf or wkhtmltopdf /tmp/google.html google.local.pdf

可选项options

wkhtmltopdf --lowquality --quiet --load-error-handling ignore --load-media-error-handling ignore http://google.com google.pdf
更多参看：https://wkhtmltopdf.org/usage/wkhtmltopdf.txt 或者wkhtmltoimage -h

三、PHP包php-htmltopdf-htmltoimage

将wkhtmltopdf封装成一个PHP包，github地址：https://github.com/biaoqianwo/php-htmltopdf-htmltoimage

四、docker微服务完整实例

简单实现一个（无须第三方框架的）：
POST http://html2pdf-serve/index.php
输入：html(string),options(array),type(pdf|image)
输出：pdf和图片源码

创建项目app
下载wkhtmltox-0.12.4_linux-generic-amd64.tar.xz到app目录下（省去耗时的下载过程）
新建composer.json：

{
    "require": {
        "biaoqianwo/php-htmltopdf-htmltoimage": "^1.1"
    }
}

然后执行composer install。
或者composer require biaoqianwo/php-htmltopdf-htmltoimage
如果主机没有安装composer的话，怎么办？就需要用到composer的镜像。请自行学习。

新建index.php文件：

<?php
require __DIR__ . '/vendor/autoload.php';

use Biaoqianwo\Html2Pdf\Html2Pdf;
use Biaoqianwo\Html2Pdf\Html2Image;

$post = $_POST;
$html = $post['html'];
$options = $post['options'];
$type = $post['type'];

if ($type == 'image') {
    // Image
    $generator = new Html2Image('/usr/local/bin/wkhtmltoimage');
    $result = $generator->getOutputFromHtml($html, $options);
} else {
    // Pdf
    $generator = new Html2Pdf('/usr/local/bin/wkhtmltopdf');
    $result = $generator->getOutputFromHtml($html, $options);
}
echo $result;

书写Dockerfile,内容如下：

FROM php:7.1-apache

MAINTAINER 704872038@qq.com

RUN apt-get update

# Install dependencies needed for wkhtmltopdf
RUN apt-get install -y libxrender1 libfontconfig1 libxext6 fonts-arphic-bkai00mp fonts-arphic-bsmi00lp \
 fonts-arphic-gbsn00lp fonts-arphic-gkai00mp fonts-dejavu-core fonts-droid fonts-liberation fonts-lmodern \
 fonts-tibetan-machine xfonts-utils xfonts-75dpi xfonts-100dpi

ENV TIMEZONE="Asia/Shanghai"

# Set PHP timezone (both cli and apache)
RUN echo "date.timezone=\"${TIMEZONE}\"" > /usr/local/etc/php/conf.d/timezone.ini

# Make logs dir writable for apache user
RUN mkdir -p /var/www/html/logs
RUN chown -R www-data:www-data /var/www/html/logs

# Copy project files to the image
COPY . /var/www/html

# Install wkhtmltopdf
RUN tar xf wkhtmltox-0.12.4_linux-generic-amd64.tar.xz && rm wkhtmltox-0.12.4_linux-generic-amd64.tar.xz
RUN ln -s -T /var/www/html/wkhtmltox/bin/wkhtmltopdf /usr/local/bin/wkhtmltopdf && \
 chmod a+x /usr/local/bin/wkhtmltopdf && \
 ln -s -T /var/www/html/wkhtmltox/bin/wkhtmltoimage /usr/local/bin/wkhtmltoimage && \
 chmod a+x /usr/local/bin/wkhtmltoimage

# Make logs dir mountable
VOLUME /var/www/html/logs

然后,创建一个镜像 docker build -t biaoqianwo/html2pdf .
然后，开启微服务（运行一个容器）：docker run --publish 8080:80 --name html2pdf-server biaoqianwo/html2pdf
这样，就可以通过接口（比如postman，cURL等工具）测试了。

进一步优化

新建一个run.sh,将上述过程放到一个shell脚本中完成，实现bash run.sh开始一个微服务。

#!/bin/sh
# Install php dependencies
composer install
composer cleanable

# Use 'latest' tag if it is unset, or explicitly set to null.
docker build --tag=biaoqianwo/html2pdf:${TAG:-'latest'} .

# run a container
docker run \
    --detach \
    --publish 8080:80 \
    biaoqianwo/html2pdf:${TAG:-'latest'}