在Laravel中高效合并PDF文件：基于libmergepdf的专业指南

composer require hanneskod/libmergepdf

<?php

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

use Hanneskod\Pdf\Pdf;
use Hanneskod\Pdf\File;

// 假设我们有两个PDF文件：一个动态生成，一个用户上传
$pdfPath1 = storage_path('app/generated.pdf'); // 动态生成的PDF路径
$pdfPath2 = storage_path('app/uploads/user_upload.pdf'); // 用户上传的PDF路径

// 确保这些文件存在，这里仅作示例
// file_put_contents($pdfPath1, '...some generated PDF content...');
// file_put_contents($pdfPath2, '...some uploaded PDF content...');

try {
    // 创建Pdf对象
    $pdf = new Pdf();

    // 添加第一个PDF文件
    // 您可以直接添加文件路径
    $pdf->addFile($pdfPath1);

    // 添加第二个PDF文件
    // 也可以添加文件内容（字符串）或文件流
    // 例如：$pdf->addRaw(file_get_contents($pdfPath2));
    $pdf->addFile($pdfPath2);

    // 合并并保存为新文件
    $outputFilePath = storage_path('app/merged_document.pdf');
    file_put_contents($outputFilePath, $pdf->render());

    echo "PDF文件已成功合并到：{$outputFilePath}\n";
} catch (\Exception $e) {
    echo "PDF合并失败: " . $e->getMessage() . "\n";
}

<?php

namespace App\Services;

use Hanneskod\Pdf\Pdf;
use Hanneskod\Pdf\Exception\PdfException;
use Illuminate\Support\Facades\Log;

class MergePdfService
{
    /**
     * 合并多个PDF文件为一个。
     *
     * @param array $pdfFilePaths 包含要合并的PDF文件路径的数组。
     * @param string|null $outputFilePath 如果指定，则将合并后的PDF保存到此路径。
     * @return string 合并后的PDF内容的二进制字符串。
     * @throws \Exception 如果合并过程中发生错误。
     */
    public function merge(array $pdfFilePaths, ?string $outputFilePath = null): string
    {
        if (empty($pdfFilePaths)) {
            throw new \InvalidArgumentException('至少需要提供一个PDF文件路径进行合并。');
        }

        $pdf = new Pdf();

        foreach ($pdfFilePaths as $path) {
            if (!file_exists($path)) {
                Log::error("PDF合并服务：文件不存在 - " . $path);
                throw new \Exception("PDF文件不存在: " . $path);
            }
            try {
                $pdf->addFile($path);
            } catch (PdfException $e) {
                Log::error("PDF合并服务：添加文件失败 - " . $path . " 错误: " . $e->getMessage());
                throw new \Exception("无法添加PDF文件 '{$path}': " . $e->getMessage());
            }
        }

        try {
            $mergedContent = $pdf->render();

            if ($outputFilePath) {
                file_put_contents($outputFilePath, $mergedContent);
            }

            return $mergedContent;
        } catch (PdfException $e) {
            Log::error("PDF合并服务：渲染合并PDF失败 - " . $e->getMessage());
            throw new \Exception("渲染合并PDF时发生错误: " . $e->getMessage());
        }
    }
}

<?php

namespace App\Http\Controllers;

use App\Services\MergePdfService;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\Response;
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('dejavusans', '', 12);
        $tcpdf->Write(0, '这是动态生成的第一份PDF内容。');
        $generatedPdfPath = Storage::path('temp/generated_dynamic.pdf');
        $tcpdf->Output($generatedPdfPath, 'F'); // 保存到文件

        // 2. 假设用户已上传第二个PDF，并将其存储在某个位置
        // 实际应用中，您会从数据库或请求中获取上传PDF的路径
        $uploadedPdfPath = Storage::path('uploads/user_document.pdf');

        // 确保上传的PDF存在，这里仅作示例
        // Storage::put('uploads/user_document.pdf', '...some uploaded PDF content...');
        if (!Storage::exists('uploads/user_document.pdf')) {
             return response()->json(['error' => '用户上传的PDF文件不存在。'], 404);
        }

        try {
            // 合并PDF文件
            $mergedPdfContent = $this->mergePdfService->merge([
                $generatedPdfPath,
                $uploadedPdfPath
            ]);

            // 清理临时文件
            Storage::delete('temp/generated_dynamic.pdf');

            // 返回合并后的PDF作为下载
            return Response::make($mergedPdfContent, 200, [
                'Content-Type' => 'application/pdf',
                'Content-Disposition' => 'attachment; filename="merged_document.pdf"',
                'Content-Length' => strlen($mergedPdfContent),
            ]);

        } catch (\Exception $e) {
            // 记录错误并返回用户友好的消息
            Log::error("合并PDF失败: " . $e->getMessage());
            return response()->json(['error' => '无法合并PDF文件，请稍后再试。'], 500);
        }
    }
}