agilize/libreoffice

LibreOffice微服务镜像

基于Alpine的LibreOffice容器服务，将LibreOffice功能封装为可通过HTTP接口访问的微服务，用于文件格式转换及文档处理。

镜像概述

该镜像将LibreOffice运行在轻量级Alpine容器中，提供便捷的文档处理能力。通过HTTP POST请求即可提交文件并获取处理结果，适用于需要集成文档转换功能的应用场景。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• HTTP接口：通过简单的HTTP POST请求实现文件处理
• 灵活配置：支持传递LibreOffice命令行参数，实现多样化文档处理需求
• 广泛格式支持：支持LibreOffice支持的所有文档格式转换（如DOCX转PDF、ODT转DOC等）

使用场景

• Web应用中的文档格式转换功能集成
• 自动化办公系统中的批量文档处理
• 需要跨平台文档处理能力的服务架构

使用方法

运行容器

通过以下命令启动LibreOffice微服务容器：

bash
docker run -d -p 29881:80 agilize/libreoffice

基本使用示例

使用curl发送POST请求处理文件（以DOCX转PDF为例）：

bash
curl -X POST -vv -F 'file=@demo.docx' http://localhost:29881 -o demo.pdf

PHP调用示例

php
<?php

$demoPath = realpath('./demo.docx');

// 可配置LibreOffice选项（参考官方文档）
$libreofficeOptions = [
    // 例如: '-headless', '-norestore' 等参数
];

// 设置请求体
$data = [
    'file' => curl_file_create($demoPath),
    'options' => json_encode($libreofficeOptions) // 传递LibreOffice参数
];

// 设置请求头
$headers = [
];

// cURL配置
$options = [
    CURLOPT_URL            => 'http://localhost/',
    CURLOPT_PORT           => 29881,
    CURLOPT_POST           => 1,
    CURLOPT_POSTFIELDS     => $data,
    CURLOPT_HTTPHEADER     => $headers,
    CURLOPT_RETURNTRANSFER => true
];

// 执行请求
$ch = curl_init();
curl_setopt_array($ch, $options);
$result = curl_exec($ch);
curl_close($ch);

// 输出处理结果
echo $result;

配置选项

可通过options参数传递LibreOffice命令行参数，所有可用参数详见LibreOffice官方文档。常见参数包括：

• -headless：无界面模式运行
• -norestore：禁用文档恢复
• -convert-to：指定输出格式（如pdf、doc等）