在Laravel中高效合并PDF文件的专业指南

composer require hanneskod/libmergepdf

<?php

require 'vendor/autoload.php'; // 确保Composer自动加载文件已引入

use Hanneskod\Pdf\Merge\Merger;

// 假设您有两个PDF文件
$pdf1Path = storage_path('app/generated_report.pdf'); // 动态生成的PDF路径
$pdf2Path = storage_path('app/user_upload.pdf');     // 用户上传的PDF路径

try {
    $merger = new Merger();

    // 添加第一个PDF文件
    $merger->addFile($pdf1Path);

    // 添加第二个PDF文件
    $merger->addFile($pdf2Path);

    // 合并PDF并获取内容
    $mergedPdfContent = $merger->merge();

    // 将合并后的PDF保存到文件或直接发送到浏览器
    file_put_contents(storage_path('app/merged_document.pdf'), $mergedPdfContent);

    echo "PDF文件已成功合并并保存到 merged_document.pdf\n";

} catch (\Exception $e) {
    echo "PDF合并失败: " . $e->getMessage() . "\n";
}

?>

// app/Services/MergePdfService.php
<?php

namespace App\Services;

use Hanneskod\Pdf\Merge\Merger;
use Illuminate\Support\Facades\Log;
use Exception;

class MergePdfService
{
    /**
     * 合并多个PDF文件。
     *
     * @param array $pdfPaths 包含要合并的PDF文件路径的数组
     * @param string $outputPath 合并后PDF的保存路径
     * @return bool 返回合并是否成功
     */
    public function mergePdfs(array $pdfPaths, string $outputPath): bool
    {
        if (empty($pdfPaths)) {
            Log::warning('MergePdfService: 没有提供任何PDF文件路径进行合并。');
            return false;
        }

        try {
            $merger = new Merger();

            foreach ($pdfPaths as $path) {
                if (!file_exists($path) || !is_readable($path)) {
                    Log::error("MergePdfService: PDF文件不存在或不可读: {$path}");
                    throw new Exception("PDF文件不存在或不可读: {$path}");
                }
                $merger->addFile($path);
            }

            $mergedPdfContent = $merger->merge();
            file_put_contents($outputPath, $mergedPdfContent);

            return true;
        } catch (Exception $e) {
            Log::error("MergePdfService: PDF合并失败 - " . $e->getMessage());
            return false;
        }
    }

    /**
     * 合并多个PDF文件内容流。
     *
     * @param array $pdfContents 包含要合并的PDF内容字符串的数组
     * @param string $outputPath 合并后PDF的保存路径
     * @return bool 返回合并是否成功
     */
    public function mergePdfStreams(array $pdfContents, string $outputPath): bool
    {
        if (empty($pdfContents)) {
            Log::warning('MergePdfService: 没有提供任何PDF内容流进行合并。');
            return false;
        }

        try {
            $merger = new Merger();

            foreach ($pdfContents as $content) {
                if (!is_string($content) || empty($content)) {
                    Log::error("MergePdfService: 提供无效的PDF内容流。");
                    throw new Exception("提供无效的PDF内容流。");
                }
                $merger->addString($content); // 使用 addString 方法处理内容流
            }

            $mergedPdfContent = $merger->merge();
            file_put_contents($outputPath, $mergedPdfContent);

            return true;
        } catch (Exception $e) {
            Log::error("MergePdfService: PDF合并失败 - " . $e->getMessage());
            return false;
        }
    }
}

// app/Http/Controllers/DocumentController.php
<?php

namespace App\Http\Controllers;

use App\Services\MergePdfService;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
use TCPDF; // 假设您使用TCPDF生成第一个PDF

class DocumentController extends Controller
{
    protected $mergePdfService;

    public function __construct(MergePdfService $mergePdfService)
    {
        $this->mergePdfService = $mergePdfService;
    }

    public function downloadMergedPdf(Request $request)
    {
        // 1. 生成第一个PDF (例如使用TCPDF)
        $tcpdf = new TCPDF();
        $tcpdf->AddPage();
        $tcpdf->SetFont('helvetica', '', 12);
        $tcpdf->Write(0, '这是动态生成的报告内容。');
        // 获取TCPDF的输出内容，而不是保存到文件
        $generatedPdfContent = $tcpdf->Output('', 'S'); // 'S' 返回PDF内容作为字符串

        // 2. 处理用户上传的PDF
        // 假设用户上传的PDF已保存到 storage/app/uploads 目录下
        // 实际应用中，您需要处理文件上传逻辑，获取其路径
        $uploadedPdfPath = Storage::path('uploads/user_attachment.pdf');

        // 临时保存生成的PDF内容，以便 mergePdfs 方法可以读取文件路径
        // 或者使用 mergePdfStreams 方法直接处理内容流
        $tempGeneratedPdfPath = Storage::path('temp/generated_report_temp.pdf');
        Storage::put('temp/generated_report_temp.pdf', $generatedPdfContent);


        // 3. 定义合并后PDF的输出路径
        $finalMergedPdfPath = Storage::path('merged_documents/final_document.pdf');
        // 确保输出目录存在
        Storage::makeDirectory('merged_documents');

        // 4. 调用服务进行PDF合并
        $pdfPathsToMerge = [
            $tempGeneratedPdfPath,
            $uploadedPdfPath,
        ];

        if ($this->mergePdfService->mergePdfs($pdfPathsToMerge, $finalMergedPdfPath)) {
            // 清理临时文件
            Storage::delete('temp/generated_report_temp.pdf');

            // 提供合并后的PDF供下载
            return response()->download($finalMergedPdfPath, '最终文档.pdf')->deleteFileAfterSend(true);
        } else {
            // 清理临时文件
            Storage::delete('temp/generated_report_temp.pdf');
            return back()->with('error', '无法合并PDF文件。');
        }
    }
}