tecnickcom / tc-lib-pdf-page

4.16.3 2026-09-05 07:37 UTC

Requires

• php: ^8.2
• ext-zlib: *
• tecnickcom/tc-lib-color: ^3.0
• tecnickcom/tc-lib-pdf-encrypt: ^2.11

Requires (Dev)

• carthage-software/mago: 1.47.6
• pdepend/pdepend: ^2.16
• phpunit/phpunit: ^11.5 || ^12.5 || ^13.3

LGPL-3.0-or-later

• Nicola Asuni

• page
• pdf
• format
• tc-lib-pdf-page

Published on Packagist.org on 2026-09-05 07:37 UTC

README

PHP library to define and render PDF pages.

💖 Part of the tc-lib-pdf / TCPDF ecosystem (100M+ installs). Sponsor its maintenance →

Overview

tc-lib-pdf-page keeps the page stack of a PDF document and outputs the page tree, the page objects and the content streams.

Namespace	\Com\Tecnick\Pdf\Page
Author	Nicola Asuni [e-mail]
License	GNU LGPL v3 - see LICENSE
API docs	https://tcpdf.org/docs/srcdoc/tc-lib-pdf-page
Packagist	https://packagist.org/packages/tecnickcom/tc-lib-pdf-page

Features

Page geometry

• Named page formats (ISO, ANSI, JIS, envelopes, photographic and other series) and custom sizes
• Portrait, landscape and size-derived orientation
• Conversion between points, millimeters, centimeters and inches
• MediaBox, CropBox, BleedBox, TrimBox and ArtBox, each with its BoxColorInfo guidelines
• Page, header, content and footer margins, with mirrored gutters in booklet mode
• Writable regions: equal columns, or rectangles computed around no-write areas

Page stack

• Add, clone, move, delete and select pages, grouped for per-group numbering
• Page content stack with marks, and ~#PN / ~#PT page number aliases
• Annotation references, rotation, preferred zoom and page transitions
• Per-page transparency group policy, disabled in PDF/A mode
• PDF output with optional Flate compression and encryption

Enums

• Unit, Orientation, PageBoxType, PageLayout, PageDisplayMode, TransparencyGroupMode

Requirements

• PHP 8.2 or later
• Extension: zlib
• Composer

Installation

composer require tecnickcom/tc-lib-pdf-page

Quick Start

<?php

require_once __DIR__ . '/vendor/autoload.php';

$page = new \Com\Tecnick\Pdf\Page\Page(
    'mm',
    new \Com\Tecnick\Color\Pdf(),
    new \Com\Tecnick\Pdf\Encrypt\Encrypt(false),
);

$page->add([
    'format' => 'A4',
    'orientation' => 'P',
    'margin' => ['PL' => 20, 'PR' => 20, 'PT' => 15, 'PB' => 15],
    'columns' => 2,
]);

$page->addContent('BT /F1 12 Tf 100 700 Td (Page ~#PN of ~#PT) Tj ET');

$pon = 0;
$pdfpages = $page->getPdfPages($pon);

add() returns the sanitized page data, including the page boxes in points, the normalized margins and the writable regions. getPdfPages() returns the PDF objects of the whole stack and advances $pon past the last object number used.

Development

make deps
make help
make qa

Packaging

make rpm
make deb

For system packages, bootstrap with:

require_once '/usr/share/php/Com/Tecnick/Pdf/Page/autoload.php';

Contributing

Contributions are welcome. Please review CONTRIBUTING.md, CODE_OF_CONDUCT.md, and SECURITY.md.