PHP应用与LibreOffice微服务：Docker环境下文档转换的最佳实践

version: '3.8'

services:
  nginx:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx/default.conf:/etc/nginx/conf.d/default.conf
      - ./app:/var/www/html
    depends_on:
      - php-fpm
      - converter # 确保Nginx可以访问converter，如果需要直接代理或转发
    networks:
      - app-network

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

  converter:
    image: sgbj/versed:latest # 使用Versed官方镜像
    environment:
      - PORT=3000 # Versed服务默认监听端口
    networks:
      - app-network
    # 如果需要，可以挂载一个卷用于持久化日志或临时文件
    # volumes:
    #   - ./converter_data:/app/data

networks:
  app-network:
    driver: bridge

<?php

namespace App\Http\Controllers;

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

class DocumentConversionController extends Controller
{
    /**
     * 将上传的文档转换为指定格式。
     *
     * @param Request $request
     * @return \Illuminate\Http\Response|\Illuminate\Http\RedirectResponse
     */
    public function convertDocument(Request $request)
    {
        // 确保文件已上传
        if (!$request->hasFile('document') || !$request->file('document')->isValid()) {
            return back()->withErrors('请上传有效的文档文件。');
        }

        $uploadedFile = $request->file('document');
        $sourceFilePath = $uploadedFile->getPathname(); // 获取上传文件的临时路径
        $originalExtension = $uploadedFile->getClientOriginalExtension();
        $targetFormat = $request->input('format', 'pdf'); // 默认转换为PDF，也可以是txt等

        // 定义转换后文件的存储路径和文件名
        $outputFileName = 'converted_document.' . $targetFormat;
        $outputFilePath = public_path($outputFileName);

        // 打开源文件进行读取
        $handler = fopen($sourceFilePath, 'r');
        if (!$handler) {
            return back()->withErrors('无法打开源文件进行转换。');
        }

        try {
            // 向转换微服务发送POST请求
            $response = Http::timeout(30) // 设置较长的超时时间，以应对大文件转换
                            ->attach('file', $handler, $uploadedFile->getClientOriginalName()) // 附加文件
                            ->withOptions([
                                'sink' => $outputFilePath // 将响应直接保存到指定文件
                            ])
                            ->post(config('custom.converter_endpoint'), [
                                'format' => $targetFormat, // 请求转换的目标格式
                            ]);

            if ($response->successful()) {
                // 转换成功，可以删除原始上传的临时文件
                // unlink($sourceFilePath); // 如果文件是临时上传的，可以在这里删除
                return response()->download($outputFilePath)->deleteFileAfterSend(true); // 下载转换后的文件并删除
            } else {
                // 转换服务返回错误
                \Log::error('文档转换失败：', ['status' => $response->status(), 'body' => $response->body()]);
                return back()->withErrors('文档转换失败，请稍后再试。');
            }
        } catch (ConnectionException $e) {
            // 转换服务不可用或网络连接失败
            \Log::error('文档转换服务连接失败：' . $e->getMessage());
            return back()->withErrors('文档转换服务当前不可用，请联系管理员。');
        } catch (Exception $e) {
            // 其他未知错误
            \Log::error('文档转换过程中发生未知错误：' . $e->getMessage());
            return back()->withErrors('文档转换过程中发生错误。');
        } finally {
            fclose($handler); // 确保关闭文件句柄
        }
    }
}

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

CONVERTER_ENDPOINT=http://converter:3000/convert