在Linux平台使用PHP将Word文档转换为PDF的方法

gitbox 2025-06-13

1. 简介

在Linux平台上，使用PHP将Word文档转换为PDF是一个常见的需求。本文将介绍如何在Linux系统上实现将Word文档转换为PDF的方法。

2. 安装依赖

2.1. LibreOffice

LibreOffice是一个开源的办公软件套件，支持多种文档格式的处理，包括Word和PDF文件。在Linux系统中，可以使用以下命令安装LibreOffice：

sudo apt-get install libreoffice

安装完成后，使用命令行输入libreoffice可以验证安装是否成功。

3. 转换过程

3.1. 准备工作

在开始转换之前，请确保服务器已安装PHP，并且具有相应的读写权限。同时，需要将待转换的Word文档上传到服务器上的指定目录，例如/var/www/html/uploads。

3.2. PHP代码实现

以下是一个使用PHP将Word文档转换为PDF的示例代码：

$wordFilePath = '/var/www/html/uploads/word.docx';
$pdfFilePath = '/var/www/html/uploads/pdf.pdf';
// 使用LibreOffice命令将Word文档转换为PDF
$command = "libreoffice --headless --convert-to pdf {$wordFilePath} --outdir {$pdfFilePath}";
// 执行转换命令
exec($command);
// 检查转换是否成功
if (file_exists($pdfFilePath)) {
    echo '转换成功！';
} else {
    echo '转换失败！';
}

在这段代码中，$wordFilePath和$pdfFilePath分别指向待转换的Word文档和生成的PDF文件的路径。使用exec()函数执行libreoffice命令来完成转换，--headless表示无界面模式运行，--convert-to pdf指定转换为PDF格式，--outdir指定输出目录。

执行完成后，检查生成的PDF文件是否存在，以确认转换是否成功。

3.3. 运行代码

将上述代码保存为convert.php文件，并上传到Web服务器根目录。然后，通过浏览器访问http://localhost/convert.php，即可执行转换任务。

转换成功后，生成的PDF文件将保存在指定目录，可以提供下载或直接展示给用户。

4. 总结

本文介绍了如何在Linux平台上使用PHP将Word文档转换为PDF的方法。借助LibreOffice命令，配合PHP代码，可以轻松实现文档格式的转换。

对于需要进行大量文档转换的场景，可以将此代码封装为函数，并结合其他功能实现批量转换或定时任务。例如，使用定时任务调度工具每天自动转换上传的Word文件。