使用PHP和LibreOffice实现高效Word转PDF的完整方案

# 使用yum安装
sudo yum install libreoffice libreoffice-headless

# CentOS 8及以上使用dnf
sudo dnf install libreoffice libreoffice-headless

libreoffice --version

; 编辑php.ini文件
disable_functions = ; 确保exec不在这个列表中

which libreoffice  # 查看可执行文件位置
rpm -ql libreoffice | grep -i "soffice$"  # 查看关键执行文件

<?php
/**
 * 批量将Word文件转换为PDF
 * 需要服务器安装LibreOffice/OpenOffice
 */
class WordToPdfConverter {
    // LibreOffice可执行文件路径
    private $libreOfficePath;
    
    // 构造函数，设置LibreOffice路径
    public function __construct($libreOfficePath = '/usr/bin/libreoffice') {
        $this->libreOfficePath = $libreOfficePath;
    }
    
    /**
     * 检查LibreOffice是否可用
     */
    public function checkLibreOffice() {
        if (!file_exists($this->libreOfficePath)) {
            throw new Exception("LibreOffice未找到，请检查路径设置");
        }
        return true;
    }
    
    /**
     * 转换单个Word文件为PDF
     * @param string $inputFile 输入Word文件路径
     * @param string $outputDir 输出PDF目录
     * @return bool 转换是否成功
     */
    public function convertToPdf($inputFile, $outputDir) {
        // 检查输入文件是否存在
        if (!file_exists($inputFile)) {
            throw new Exception("输入文件不存在: " . $inputFile);
        }
        
        // 确保输出目录存在
        if (!file_exists($outputDir)) {
            mkdir($outputDir, 0755, true);
        }
        
        // 获取文件名（不含扩展名）
        $filename = pathinfo($inputFile, PATHINFO_FILENAME);
        
        // 核心-构建转换命令 
        // --headless: 无界面模式
        // --convert-to pdf: 转换为PDF
        // --outdir: 输出目录
        $command = escapeshellcmd($this->libreOfficePath) . 
                   " --headless --convert-to pdf " . 
                   escapeshellarg($inputFile) . 
                   " --outdir " . escapeshellarg($outputDir);
        
        // 执行命令
        \exec($command, $output, $returnVar); //全局
        
        // 检查是否转换成功
        $pdfFile = $outputDir . '/' . $filename . '.pdf';
        if ($returnVar === 0 && file_exists($pdfFile)) {
            return [
                'success' => true,
                'pdf_path' => $pdfFile,
                'message' => '转换成功'
            ];
        } else {
            return [
                'success' => false,
                'input_file' => $inputFile,
                'message' => '转换失败，错误码: ' . $returnVar . ', 输出: ' . implode("\n", $output)
            ];
        }
    }
    
    /**
     * 批量转换目录中的Word文件
     * @param string $inputDir 输入目录
     * @param string $outputDir 输出目录
     * @param array $extensions 要处理的文件扩展名
     * @return array 转换结果
     */
    public function batchConvert($inputDir, $outputDir, $extensions = ['doc', 'docx']) {
        if (!is_dir($inputDir)) {
            throw new Exception("输入目录不存在: " . $inputDir);
        }
        
        $results = [];
        $directory = new RecursiveDirectoryIterator($inputDir);
        $iterator = new RecursiveIteratorIterator($directory);
        $regex = new RegexIterator($iterator, '/^.+\.(' . implode('|', $extensions) . ')$/i', RecursiveRegexIterator::GET_MATCH);
        
        foreach ($regex as $file) {
            $filePath = $file[0];
            $results[] = $this->convertToPdf($filePath, $outputDir);
        }
        
        return $results;
    }
}

// 使用示例
try {
    // 根据操作系统设置正确的LibreOffice路径
    // Windows示例: 'C:/Program Files/LibreOffice/program/soffice.exe'
    // Linux示例: '/usr/bin/libreoffice'
    // Mac示例: '/Applications/LibreOffice.app/Contents/MacOS/soffice'
    $converter = new WordToPdfConverter('/usr/bin/libreoffice');
    
    // 检查LibreOffice是否可用
    $converter->checkLibreOffice();
    
    // 设置输入和输出目录
    $inputDir = '/path/to/word/files';    // Word文件所在目录
    $outputDir = '/path/to/pdf/output';   // PDF输出目录
    
    // 批量转换
    $results = $converter->batchConvert($inputDir, $outputDir);
    
    // 输出结果
    echo "转换完成，结果如下:\n";
    foreach ($results as $result) {
        if ($result['success']) {
            echo "成功: " . $result['pdf_path'] . "\n";
        } else {
            echo "失败: " . $result['input_file'] . " - " . $result['message'] . "\n";
        }
    }
} catch (Exception $e) {
    echo "错误: " . $e->getMessage() . "\n";
}
?>

// Windows系统
$converter = new WordToPdfConverter('C:/Program Files/LibreOffice/program/soffice.exe');

// Linux系统
$converter = new WordToPdfConverter('/usr/bin/libreoffice');

// macOS系统
$converter = new WordToPdfConverter('/Applications/LibreOffice.app/Contents/MacOS/soffice');