分享一个用 PHP 开发 PDF 文件生成工具，支持 HTML 模板、API 调用、Docker 部署

luler 的个人博客 / 214 / 4 / 创建于 3周前 / 更新于 3周前

一、简介

该工具采用前后端分离的开发方式，后端基于 ThinkPHP 框架（开发相关的API），前端使用Ant Design Pro框架（开发相关页面）
提供多用户管理，PDF模板管理、审核、预览等功能，提供 PDF 生成的开放API
主要功能特点是：可以通过调用相关接口，根据后台PDF模板或者根据提供HTML代码动态渲染生成 PDF 文件
支持使用 Docker 一键快速部署启用
该项目的github地址参考：github.com/luler/hello_pdf_templat...
该项目的主要技术架构和工作原理参考下图：

Laravel

二、安装

提前安装好Docker、docker-compose软件运行环境

拉取源代码

git clone https://github.com/luler/hello_pdf_template.git

进入代码根目录，根据需要编辑docker-compose.yml配置文件，参考如下内容：

version: '3'
services:
php_nginx:
  image: registry.cn-shenzhen.aliyuncs.com/luler/linux_php_nginx:php7.3
  restart: always
  privileged: true
  ports:
    - 12345:80
  volumes:
    - ./config/init.sh:/init.sh #初始化脚本
    - ./runtime/wwwlogs:/home/wwwlogs #nginx日志
    - ./code:/home/wwwroot #代码、sqlite数据
    - ./config/nginx/conf:/usr/local/nginx/conf #nginx配置
    - ./config/php/etc:/usr/local/php/etc #php-fpm配置

直接在根目录下执行下面命令一键启动
```
docker-compose up -d
```
启动之后，服务正常运行，即可访问使用

三、使用

1. 登录后台，创建PDF模板

安装完成之后，服务运行在12345端口上，可以打开浏览器访问：http://ip:12345/，默认登录账号密码：admin/admin

进入模板列表，新增一个模板
点击新增模板按钮
Laravel
填写模板内容，支持富文本、纯代码的编辑方式，兼容各种HTML语法。下面是测试简单的购物单模板（使用了thinkphp的模板渲染引擎）

<h1>发票</h1>
<p>发票号码：{$code}</p>
<p>日期：{$date}</p>
<p>客户：{$client}</p>
<table border="1" cellspacing="0" style="border-collapse:collapse; width:100%">
  <thead>
      <tr>
          <th>商品</th>
          <th>图片</th>
          <th>数量</th>
          <th>单价</th>
          <th>金额</th>
      </tr>
  </thead>
  <tbody>
  {foreach $list as $key=>$vo } 
      <tr>
          <td>{$vo.name}</td>
          <td><img width=80 height=80 src="{$vo.image}"></td>
          <td>{$vo.num}</td>
          <td>{$vo.price}元</td>
          <td>{$vo.money}元</td>
      </tr>
  {/foreach}
      <tr>
          <td colspan="4">总计</td>
          <td>{$total_money}元</td>
      </tr>
  </tbody>
</table>
<p>备注：感谢您的购买！</p>

可以预览生成
Laravel

2. 模板创建完成后，可以调用 API 生成PDF文件

获取访问凭证接口

接口（POST）：/api/getAccessToken
请求参数（json）：
{
  "type": 1, //默认1
  "appid": "admin", //账号
  "appsecret": "admin" //密码
}
返回（json）：
{
  "message": "获取成功",
  "code": 200,
  "info": {
      "access_token": "Bearer eyJ0eXAiOiJKV1Q...", //访问凭证
      "token_type": "Bearer",
      "expires_in": 864000, //有效时间，单位秒
      "user_info": { //用户信息
          "id": "1",
          "title": "admin",
          ...
      }
  }
}

根据后台模板创建PDF接口

接口（POST）：/api/downloadPdf
请求参数（json）：
{
  "authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbG", //访问凭证
  "code": "689966350ed4d",  //模板代码
  "param": { //模板参数（thinkphp模板渲染引擎）
     "key": "value"
  }
}
返回（json）：
{
  "message": "获取成功",
  "code": 200,
  "info": {
      "file_url": "http://ip:12345/backend/pdf/689a0c01ec349.pdf" //生成临时PDF
  }
}

根据HTML格式内容渲染生成PDF文件接口

接口（POST）：/api/downloadPdf
请求参数（json）：
{
  "authorization": "Bearer eyJ0eXAiOiJKV1QiLCJhbG", //访问凭证
  "content": "<h1>这是一个测试</h1><ul><li>1111111</li></ul>",  //HTML代码
  "render_direction": 1 //渲染方向，1-纵向（默认），2-横向
}
返回（json）：
{
  "message": "获取成功",
  "code": 200,
  "info": {
      "file_url": "http://ip:12345/backend/pdf/689a0c01ec349.pdf" //生成临时PDF
  }
}