Download the PHP package tecnickcom/tc-lib-pdf-parser without Composer
On this page you can find all versions of the php package tecnickcom/tc-lib-pdf-parser. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download tecnickcom/tc-lib-pdf-parser
More information about tecnickcom/tc-lib-pdf-parser
Files in tecnickcom/tc-lib-pdf-parser
Package tc-lib-pdf-parser
Short Description PHP library to parse PDF documents
License LGPL-3.0-or-later
Homepage https://tcpdf.org
Informations about the package tc-lib-pdf-parser
tc-lib-pdf-parser
Parser library for reading and extracting PDF document structures.
💖 Part of the tc-lib-pdf / TCPDF ecosystem (100M+ installs). Sponsor its maintenance →
Overview
tc-lib-pdf-parser parses raw PDF data into the cross-reference and trailer data of the document and an array of its objects, each decoded into a token array.
| Namespace | \Com\Tecnick\Pdf\Parser |
| Author | Nicola Asuni [email protected] |
| 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
- Cross-reference tables and cross-reference streams, including
/Prevchains and incremental updates - Object streams (
/ObjStm) - Indirect references, resolved on demand and bounded against cycles
- Stream decoding through tc-lib-pdf-filter, including the
PredictorofDecodeParms
Limits
- Maximum decoded size of a single stream
- Maximum nesting depth of arrays and dictionaries
- Maximum depth of indirect object resolutions
- Maximum number of chained cross-reference sections
Requirements
- PHP 8.2 or later
- Extension:
pcre - Composer
Configuration
The constructor accepts an array of parameters:
| Parameter | Type | Default | Meaning |
|---|---|---|---|
ignore_filter_errors |
bool |
false |
If true, a stream that fails to decode is kept as raw data instead of raising an exception |
decode_streams |
bool |
true |
If true, decode the stream payloads of the indirect objects while parsing |
max_stream_size |
int |
33554432 |
Maximum size in bytes of a single decoded stream; 0 means unlimited |
max_resolution_depth |
int |
64 |
Maximum number of indirect object resolutions in flight at once; values below 1 are clamped to 1 |
max_nesting_depth |
int |
256 |
Maximum nesting depth of array and dictionary objects; values below 1 are clamped to 1 |
strict_limits |
bool |
false |
If true, raise a LimitException as soon as a limit or a reference cycle leaves an object unresolved |
Parsing Limits
Two limits bound the work a document can ask the parser to do. Both bound a recursion and cannot be
disabled: a value below 1 is clamped to 1.
Exceeding max_nesting_depth always raises Com\Tecnick\Pdf\Parser\LimitException, a subclass of
Com\Tecnick\Pdf\Parser\Exception: a dictionary or array that cannot be tokenized has no usable
value to fall back to.
Reaching max_resolution_depth, or meeting a reference cycle, leaves the reference unresolved and
lets the rest of the document parse. Both cases are recorded and readable after parse():
One warning is reported per kind of event, with the number of occurrences and the first object
affected. Setting strict_limits turns the first such event into a LimitException instead, and
getLimitWarnings() then always returns an empty list.
Installation
Quick Start
Development
Packaging
For system packages, bootstrap with:
Contributing
Contributions are welcome. Please review SECURITY.md.