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

引言在现代办公和文档处理场景中将Word文档转换为PDF格式是一项常见需求。本文将介绍如何利用PHP和LibreOffice构建一个高效、稳定的Word转PDF解决方案特别适合需要批量处理文档的Web应用场景。一、技术原理概述与常见的Word→HTML→PDF间接转换方式不同本方案采用LibreOffice直接进行格式转换具有显著优势格式保留更完整LibreOffice内部有完整的文档解析引擎能够准确处理复杂排版、特殊字体、页眉页脚等元素转换效率更高减少了中间环节的资源消耗提升处理速度避免样式丢失直接转换避免了HTML转换过程中可能出现的样式丢失和排版错乱问题二、环境准备与安装服务器环境要求安装LibreOffice办公套件PHP需要具备执行系统命令的权限根据操作系统调整LibreOffice的路径配置LibreOffice安装指南CentOS/RHEL系统安装12345# 使用yum安装sudoyuminstalllibreoffice libreoffice-headless# CentOS 8及以上使用dnfsudodnfinstalllibreoffice libreoffice-headless验证安装是否成功1libreoffice --versionPHP环境配置确保php.ini中的disable_functions不包含exec函数12; 编辑php.ini文件disable_functions ; 确保exec不在这个列表中注意⚠️编辑完成后需要重启PHP服务使配置即生效。三、LibreOffice路径说明CentOS系统了解LibreOffice的安装路径对于PHP脚本调用至关重要核心程序目录/usr/bin/libreoffice主程序执行入口实际执行文件/usr/lib64/libreoffice/program/soffice配置与资源目录/etc/libreoffice/系统级配置文件可以通过以下命令验证具体安装路径12which libreoffice # 查看可执行文件位置rpm -ql libreoffice | grep -isoffice$# 查看关键执行文件四、完整PHP实现代码以下是完整的Word转PDF转换类支持单个文件和批量转换123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130?php/*** 批量将Word文件转换为PDF* 需要服务器安装LibreOffice/OpenOffice*/classWordToPdfConverter {// LibreOffice可执行文件路径private$libreOfficePath;// 构造函数设置LibreOffice路径publicfunction__construct($libreOfficePath/usr/bin/libreoffice) {$this-libreOfficePath $libreOfficePath;}/*** 检查LibreOffice是否可用*/publicfunctioncheckLibreOffice() {if(!file_exists($this-libreOfficePath)) {thrownewException(LibreOffice未找到请检查路径设置);}returntrue;}/*** 转换单个Word文件为PDF* param string $inputFile 输入Word文件路径* param string $outputDir 输出PDF目录* return bool 转换是否成功*/publicfunctionconvertToPdf($inputFile,$outputDir) {// 检查输入文件是否存在if(!file_exists($inputFile)) {thrownewException(输入文件不存在: .$inputFile);}// 确保输出目录存在if(!file_exists($outputDir)) {mkdir($outputDir, 0755, true);}// 获取文件名不含扩展名$filenamepathinfo($inputFile, PATHINFO_FILENAME);// 核心-构建转换命令// --headless: 无界面模式// --convert-to pdf: 转换为PDF// --outdir: 输出目录$commandescapeshellcmd($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 转换结果*/publicfunctionbatchConvert($inputDir,$outputDir,$extensions [doc,docx]) {if(!is_dir($inputDir)) {thrownewException(输入目录不存在: .$inputDir);}$results [];$directorynewRecursiveDirectoryIterator($inputDir);$iteratornewRecursiveIteratorIterator($directory);$regexnewRegexIterator($iterator,/^.\.(. implode(|,$extensions) .)$/i, RecursiveRegexIterator::GET_MATCH);foreach($regexas$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$converternewWordToPdfConverter(/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($resultsas$result) {if($result[success]) {echo成功: .$result[pdf_path] .\n;}else{echo失败: .$result[input_file] . - .$result[message] .\n;}}}catch(Exception$e) {echo错误: .$e-getMessage() .\n;}?五、使用说明与注意事项1. 路径配置根据操作系统不同需要调整LibreOffice的路径12345678// Windows系统$converternewWordToPdfConverter(C:/Program Files/LibreOffice/program/soffice.exe);// Linux系统$converternewWordToPdfConverter(/usr/bin/libreoffice);// macOS系统$converternewWordToPdfConverter(/Applications/LibreOffice.app/Contents/MacOS/soffice);2. 权限设置确保PHP进程有足够的权限读取Word源文件的权限写入输出目录的权限执行LibreOffice的权限3. 安全性考虑在实际生产环境中建议对输入文件路径进行严格验证限制可转换的文件大小设置超时时间防止长时间处理考虑使用队列处理大量文件转换任务