Index

  1. Getting Started
  2. The Main Class
  3. Add Files or Documents
    1. Introduction
    2. The addFile() and addDocument() Methods
    3. Control Pages To Merge
    4. Named Destinations
    5. Outlines
    6. Layers
  4. Encrypted Documents
  5. PDF Forms
  6. Tagged PDFs
  7. Performance Optimizations
  8. PDF Portfolios (aka PDF Packages or Collections)
  9. Migrating
  10. API Reference

Add Files or Documents

Table of Contents

  1. Introduction
  2. The addFile() and addDocument() Methods

Introduction

The Merger component allows you to add PDF documents in 2 ways: It accepts a filename via the addFile() method or an existing document instance via the  addDocument() method. 

The addFile() and addDocument() Methods

Both methods are nearly identical in their method signature. The only difference is that the one accepts a path to a file and the other accepts an existing document instance. 

addDocument()

Add a document.

addFile()

Add a document by filename.

So a simplest merge process could look like:

PHP
<?php

use setasign\SetaPDF2\Core\Document;
use setasign\SetaPDF2\Core\Writer\HttpWriter;
use setasign\SetaPDF2\Merger\Merger;

require_once('library/SetaPDF/Autoload.php');

$merger = new Merger();
// add files from the file system
$merger->addFile('files/pdfs/camtown/products/Boombastic-Box.pdf');
$merger->addFile('files/pdfs/camtown/products/Fantastic-Speaker.pdf');

// initiate a document instance
$existingDocument = Document::loadByString(
    file_get_contents('files/pdfs/camtown/products/Noisy-Tube.pdf')
);
// and add this instance
$merger->addDocument($existingDocument);

// merge them together
$merger->merge();

// get the resulting document instance
$document = $merger->getDocument();
// add a writer
$document->setWriter(new HttpWriter('simple.pdf', true));
// save and finish
$document->save()->finish();

Details about the other parameters are described on the following pages:

© 2026 Setasign GmbH & Co. KG · Contact / Imprint · Data Privacy Statement (German)