tecnickcom/tc-lib-pdf-parser

PHP library to parse PDF documents

3.0.46 2026-04-20 07:16 UTC

Requires

• php: >=8.1
• ext-pcre: *
• tecnickcom/tc-lib-pdf-filter: ^2.0

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

• parser
• pdf
• document
• tc-lib-pdf-parser

README

Parser library for reading and extracting PDF document structures.

If this library helps your analysis pipeline, please consider supporting development via PayPal.

Overview

tc-lib-pdf-parser parses raw PDF data into structured PHP arrays suitable for extraction, analysis, and downstream processing.

The parser is designed for tooling scenarios such as content inspection, metadata extraction, validation, and migration pipelines. It favors clear structured output so applications can build higher-level analysis features without depending on fragile regular-expression parsing.

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

Features

Parsing Capabilities

• Cross-reference and object stream parsing
• Filter-aware stream decoding integration
• Structured output suitable for custom extractors

Runtime Design

• Configuration options for tolerant parsing modes
• Pure-PHP parser with no external service dependency
• Typed exceptions for error handling

Requirements

• PHP 8.1 or later
• Extension: pcre
• Composer

Installation

composer require tecnickcom/tc-lib-pdf-parser

Quick Start

<?php

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

$raw = file_get_contents('/path/to/document.pdf');
$parser = new \Com\Tecnick\Pdf\Parser\Parser(['ignore_filter_errors' => true]);
$data = $parser->parse((string) $raw);

var_dump($data);

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/Parser/autoload.php';

Contributing

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

Contact

Nicola Asuni - [e-mail]