neo3k/lara-pdf-merger

dev-main 2021-11-08 18:52 UTC

This package is auto-updated.

Last update: 2024-04-08 23:50:27 UTC


README

Drop-in replacement for the original package from deltaaskii/lara-pdf-merger that works under PHP 7.4

Original written by http://pdfmerger.codeplex.com/team/view

PHP 7.4 support thanks by https://github.com/DALTCORE/lara-pdf-merger

This Package was tested on Laravel 8.61.0

Improvements

  • Code source refactoring
  • Enabling the Facade use
  • Adding duplex merge feature
  • Separate save operation from the merge
  • TCPDI namespace use

Installation

  • Require this package in your composer.json by adding those lines
composer require veraandco/lara-pdf-merger
  • Run this commend in your terminal
composer update

Laravel <5.5:

After updating composer, add the ServiceProvider to the providers array in config/app.php

    Vera\LaraPdfMerger\PdfMergerServiceProvider::class,

You can optionally use the facade for shorter code. Add this to your facades:

    'PdfMerger' => Vera\LaraPdfMerger\Facades\PdfMerger::class,

Usage

use Vera\LaraPdfMerger\Facades\PdfMerger;

//...

$pdfMerger = PDFMerger::init(); //Initialize the merger

$pdfMerger->addPDF('samplepdfs/one.pdf', '1, 3, 4');
$pdfMerger->addPDF('samplepdfs/two.pdf', '1-2');
$pdfMerger->addPDF('samplepdfs/three.pdf', 'all');

//You can optionally specify a different orientation for each PDF
$pdfMerger->addPDF('samplepdfs/one.pdf', '1, 3, 4', 'L');
$pdfMerger->addPDF('samplepdfs/two.pdf', '1-2', 'P');

$pdfMerger->merge(); //For a normal merge (No blank page added)

// OR..
$pdfMerger->duplexMerge(); //Merges your provided PDFs and adds blank pages between documents as needed to allow duplex printing

// optional parameter can be passed to the merge functions for orientation (P for protrait, L for Landscape). 
// This will be used for every PDF that doesn't have an orientation specified

$pdfMerger->save("file_path.pdf");

// OR...
$pdfMerger->save("file_name.pdf", "download");
// REPLACE 'download' WITH 'browser', 'download', 'string', or 'file' for output options

Authors

Credits