Linux 服务器实现 Word 转图片方案

在很多业务系统中，经常需要对 Word 文档进行在线预览或生成图片。常见场景包括：

• 电子函件或通知预览
• 审批系统附件展示
• OCR 识别前的文档预处理
• IM / 消息系统模板截图
• 文档归档与审计

Word 文档 (.docx) 本身不适合直接渲染为图片，因此通常采用如下转换链路：

DOCX → PDF → PNG

原因：

• DOCX → PDF：排版最稳定
• PDF → PNG：渲染简单，兼容性好

本文记录一次完整的服务器环境搭建过程，使用：

• CentOS/PHP
• phpword：负责处理 Word 模板中的变量替换
• LibreOffice：负责 Word 转 PDF
• ImageMagick：负责 PDF 转 PNG

完整转换流程如下：

PHP (phpword)  ↓DOCX  ↓LibreOffice (soffice)  ↓PDF  ↓ImageMagick (convert)  ↓PNG

LibreOffice

首先在服务器安装 LibreOffice：

sudo yum install libreoffice

安装完成后可以使用 soffice进行文档转换。

测试是否安装成功：

soffice --version

接下来就可以开始 DOCX 转 PDF 了，使用命令：

# 单文件转换soffice --headless \--convert-to pdf \/tmp/upload_data/letter.docx \--outdir /tmp/upload_data

执行后会在/tmp/upload_data目录下生成letter.pdf

如果目录中有大量 Word 文件，也可以批量转换：

soffice --headless \--convert-to pdf \/tmp/upload_data/1/*.docx \--outdir /tmp/upload_data/1

执行后会在/tmp/upload_data/1/目录下生成和 docx 文件同名的 pdf 文件。

但是这个时候查看生成好的 PDF 文件，会发现字体和 Word 有区别，在 Linux 服务器上转换 Word 时，经常会遇到：

• 字体被替换
• 排版错位
• 中文显示异常

原因是服务器没有 Windows 上对应的字体。解决方法就是从 Windows 复制字体，放到服务器上。

字体目录：

C:\Windows\Fonts

常用中文字体：

将这些字体打包为fonts.zip后上传服务器，上传到服务器后执行：

unzip fonts.zip -d /usr/share/fonts/chinese

刷新字体缓存：

fc-cache -fv

查看字体：

fc-list | grep simsun

如果看到输出，说明字体安装成功。

然后重启 LibreOffice：

systemctl restart libreoffice

这样 LibreOffice 才会加载新字体，可以正常生成 PDF 文件了。

ImageMagick

转为 PDF 以后，就可以使用 ImageMagick 将 PDF 渲染为图片。

安装：

yum install -y ImageMagick ImageMagick-devel

检查版本：

convert -version

基本转换命令：

convert -density 300 letter.pdf letter.png

参数说明：

默认情况下，每页 PDF 都会生成一张图片，多页 PDF 时就会生成letter-0.png、letter-1.png...

如果需要拼接多页为一张图片，生成一张长图：

convert -density 300 letter.pdf -append letter.png

-append表示纵向拼接，+append表示横向拼接。

同时可以加上-background white -alpha remove，防止透明背景。

完整示例命令：

soffice --headless --convert-to pdf letter.docxconvert -density 300 letter.pdf -background white -alpha remove -append letter.png

通过 LibreOffice 与 ImageMagick，可以在 Linux 服务器上实现稳定的文档转换流程。