PHP中将Word文件转换为PDF

前言

在上一篇水文中，我提到了需要实现“docx转pdf”；

经过一番折腾，最终得出了一个结论：PHP可真不愧是一两面撬刀的🔨。

在尝试了使用“phpoffice/phpword”+“dompdf/mpdf”等主流PDF转换库对docx进行转换后，最后得到的效果实在是不尽人意。（错位+乱码）

虽然在Windows平台可通过“.net COM组件”这种外挂方式实现转换，但这种方法不具备跨平台特性，不方便部署，同时也不方便在日后的项目复用。

最后得到的解决方案则是通过PHP调用Python unoconv工具调用LibreOffice实现。~~（究极套娃）~~

调用unoconv

实现调用unoconv进行转换只需要简单两行代码。

/** * @param string $unoconv unoconv执行文件位置 * @param string $uno_path LibreOffice执行文件所在目录 * @param string $src 待转换的源文件路径 * @param string|null $dest 转换文件的路径 * @param string $format 转换的文件格式，需要LibreOffice支持 */function unoconv($unoconv, $uno_path, $src, $dest = null, $format = 'pdf')
{
    putenv('UNO_PATH=' . $uno_path);    shell_exec(sprintf('%s -f %s "%s" %s', $unoconv, $format, $src, empty($dest) ? '' : '-o ' . $dest));}

以下是通过“phpoffice/phpword”实现数据注入模版并转换为pdf的业务代码。（截选部分）

header('Content-Type: application/pdf');header(sprintf('Content-Disposition: attachment;filename="%s"', $cert_name));header('Cache-Control: max-age=0');$cert_path = WEB_ROOT . 'upload/' . $cert_path;$template = new TemplateProcessor($cert_path);$template->setValues($data);$src = $template->save();$ext = @pathinfo($src)['extension'];if (!empty($ext))
    $dest = str_replace('.' . $ext, '.pdf', $src);else    $dest = $src . '.pdf';unoconv($setting['unoconv'], $setting['uno_path'], $src, $dest);$io = fopen("php://output", "w");fwrite($io, readfile($dest));fclose($io);

部署unoconv环境

安装最新版本LibreOffice
安装最新版本Python（3.+）。
使用pip安装unoconv。

pip install unoconv

配置“UNO_PATH”环境变量
- /Applications/LibreOffice.app/Contents/MacOS
- C:Files

这时，一般情况下只要在终端输入unoconv，就可以看到相关帮助信息。

但注意，Windows除外，在Windows里，unoconv并不是以可执行文件的形式存在（因为没有后缀）。

那么，在Windows环境下，则需要输入**python C:*运行unoconv。

到这里，unoconv环境的部署就完成了。

PHP调用前注意

在不同的运行环境下，情况可能有所不同。

通常情况下，PHP无法获取到完整的系统环境变量。（有些环境变量配置是仅限于Shell的）

对于前面方法中的“unoconv执行文件位置”参数，建议提供绝对路径。

后记

发现PHP版unoconv。~~（dbq，是我🔨了）~~

ThinkPHP5 实现

/** * @param string $unoconv unoconv执行文件位置 * @param string $uno_path LibreOffice执行文件所在目录 * @param string $src 待转换的源文件路径 * @param string|null $dest 转换文件的路径 * @param string $format 转换的文件格式，需要LibreOffice支持 * @param int $timeout 超时时间 */function unoconv($unoconv, $uno_path, $src, $dest = null, $format = 'pdf', $timeout = 10)
{
    $builder = new \think\process\Builder();    $builder->setEnv('UNO_PATH', $uno_path);    $builder->setTimeout($timeout);    $args = [$unoconv, '-f', $format, $src];    if (!empty($dest)) {
        array_push($args, '-o');        array_push($args, $dest);    }
    $builder->setArguments($args);    $builder->getProcess()->run();}

HsOjo's Blog