tecnickcom/tc-lib-pdf-page

PHP library containing PDF page formats and definitions

4.3.18 2026-04-20 07:16 UTC

Requires

• php: >=8.1
• ext-date: *
• ext-zlib: *
• tecnickcom/tc-lib-color: ^2.3
• tecnickcom/tc-lib-pdf-encrypt: ^2.1

Requires (Dev)

• pdepend/pdepend: ^2.16
• phpcompatibility/php-compatibility: ^10.0.0@dev
• phpmd/phpmd: ^2.15
• phpunit/phpunit: ^13.1 || ^12.5 || ^11.5 || ^10.5
• squizlabs/php_codesniffer: ^4.0

LGPL-3.0-or-later

• Nicola Asuni

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

README

Page geometry, boxes, and format definitions for PDF documents.

If this library helps your layout engine, please consider supporting development via PayPal.

Overview

tc-lib-pdf-page manages page sizing, orientation, box definitions, and related geometry metadata.

It provides the structural model that document builders use to define media boxes, orientation changes, and page-level defaults consistently. Centralizing these rules improves correctness in multi-page layouts and simplifies downstream rendering code.

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 Model

• Standard and custom page size handling
• Orientation and unit conversion helpers
• Region and box definitions (CropBox, TrimBox, and related metadata)

Integration

• Supports PDF composition stacks that need deterministic page geometry
• Pairs with color/encryption libraries for complete page objects
• Typed exceptions for invalid layout parameters

Requirements

• PHP 8.1 or later
• Extensions: date, 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),
    false,
    false
);

$dims = $page->setBox([], 'CropBox', 0, 0, 210, 297);
var_dump($dims['CropBox']);

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.

Contact

Nicola Asuni - [e-mail]