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

一、简介

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

二、安装

• 提前安装好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
  

• 进入模板列表，新增一个模板
  点击新增模板按钮
  
  填写模板内容，支持富文本、纯代码的编辑方式，兼容各种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>

  可以预览生成
  

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
    }
  }

• 在Postman中调用接口生成PDF文件示例截图
  

四、总结

• 可以使用Docker快速部署，默认数据库是sqlite，无需外部依赖，但生产环境建议切换到mysql
• 该工具定位赋能组件，生成的PDF文件默认不会永久保存，定期1天清理，可调整参数控制
• 该工具可以作为系统开发的解耦组件，帮助业务系统快速生成各种特定模板的PDF文件

线上部署了一个临时试用：cas.luler.top/?search=62109f1f0ef2...

本作品采用《CC 协议》，转载必须注明作者和本文链接