Docker环境下PHP应用与LibreOffice独立服务的文件转换实践

version: '3.8'

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
      - ./src:/var/www/html
    depends_on:
      - php-fpm
    networks:
      - app-network

  php-fpm:
    build:
      context: .
      dockerfile: Dockerfile.php
    volumes:
      - ./src:/var/www/html
    networks:
      - app-network

  # LibreOffice转换服务
  converter:
    image: sgbj/versed:latest # 使用Versed镜像
    ports:
      - "3000:3000" # 可以选择性地暴露端口，但内部通信不需要
    environment:
      - MAX_FILE_SIZE=50M # 根据需要调整最大文件大小
    networks:
      - app-network

networks:
  app-network:
    driver: bridge

// config/custom.php
return [
    'converter_endpoint' => env('CONVERTER_ENDPOINT', 'http://converter:3000/convert')
];

CONVERTER_ENDPOINT=http://converter:3000/convert

<?php

namespace App\Http\Controllers;

use Illuminate\Support\Facades\Http;
use Illuminate\Http\Client\ConnectionException;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;

class DocumentConversionController extends Controller
{
    /**
     * 将上传的文档文件转换为指定格式。
     *
     * @param Request $request
     * @return \Illuminate\Http\Response|\Illuminate\Contracts\Foundation\Application|\Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
     */
    public function convertDocument(Request $request)
    {
        $request->validate([
            'document' => 'required|file|mimes:doc,docx,odt,rtf', // 允许的文档类型
            'format' => 'required|string|in:pdf,txt,html', // 目标格式
        ]);

        $uploadedFile = $request->file('document');
        $targetFormat = $request->input('format');

        // 临时存储上传的文件
        $sourceFilePath = $uploadedFile->storeAs('temp_conversions', $uploadedFile->getClientOriginalName());
        $fullSourcePath = Storage::path($sourceFilePath);

        // 构建输出文件路径
        $outputFileName = pathinfo($uploadedFile->getClientOriginalName(), PATHINFO_FILENAME) . '.' . $targetFormat;
        $fullOutputPath = Storage::path('converted_files/' . $outputFileName);

        // 打开源文件句柄
        $handler = fopen($fullSourcePath, 'r');
        if (!$handler) {
            // 文件打开失败
            Storage::delete($sourceFilePath);
            return back()->with('error', '无法打开源文件进行转换。');
        }

        try {
            $response = Http::attach(
                'file', // 表单字段名，Versed API 期望 'file'
                $handler,
                $uploadedFile->getClientOriginalName() // 文件名
            )
            ->timeout(10) // 设置请求超时时间，根据文件大小和服务器性能调整
            ->withOptions([
                'sink' => $fullOutputPath // 直接将响应流写入文件
            ])
            ->post(config('custom.converter_endpoint'), [
                'format' => $targetFormat, // 目标转换格式
            ]);

        } catch (ConnectionException $e) {
            // 转换服务不可用或连接超时
            fclose($handler);
            Storage::delete($sourceFilePath);
            return back()->with('error', '文件转换服务当前不可用，请稍后再试。');
        } finally {
            fclose($handler); // 确保文件句柄被关闭
        }

        // 处理转换结果
        if ($response->successful()) {
            // 转换成功，删除原始临时文件
            Storage::delete($sourceFilePath);
            // 返回转换后的文件路径或直接下载
            return response()->download($fullOutputPath, $outputFileName)->deleteFileAfterSend(true);
        } else {
            // 转换失败，可能需要记录错误日志并返回原始文件或错误信息
            Storage::delete($sourceFilePath);
            // 尝试删除可能已创建的输出文件（如果转换失败但部分写入）
            if (Storage::exists('converted_files/' . $outputFileName)) {
                Storage::delete('converted_files/' . $outputFileName);
            }
            $errorMessage = $response->json('message', '文件转换失败，请检查文件内容。');
            return back()->with('error', $errorMessage);
        }
    }
}