tecnickcom/tc-lib-file

PHP library to read byte-level data from files

2.3.7 2026-04-20 07:13 UTC

Requires

• php: >=8.1
• ext-curl: *
• ext-pcre: *

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

• file
• bit
• read
• Double
• byte
• long
• short
• tc-lib-file

README

PHP utilities for low-level file access and byte-level reading.

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

Overview

tc-lib-file provides safe primitives for opening files, reading bytes, and handling binary-oriented workflows used by higher-level PDF and document libraries.

The package is intentionally small but critical: it centralizes low-level I/O concerns so higher-level libraries can focus on document semantics instead of stream safety and byte handling. This separation improves reliability, testability, and reuse across the broader Tecnick ecosystem.

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

Features

File Access

• Local and URL-backed file reading helpers
• Path-safety checks for local operations
• cURL-based retrieval options for remote resources

Binary Utilities

• Byte, integer, and structured binary reads
• Helpers used by parser and image/font import stacks
• Error handling via typed exceptions

Requirements

• PHP 8.1 or later
• Extensions: curl, pcre
• Composer

Installation

composer require tecnickcom/tc-lib-file

Quick Start

<?php

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

$file = new \Com\Tecnick\File\File();
$fh = $file->fopenLocal(__FILE__, 'rb');
$header = $file->fReadInt($fh);

var_dump($header);

Development

make deps
make help
make qa

Packaging

make rpm
make deb

For system packages, bootstrap with:

require_once '/usr/share/php/Com/Tecnick/File/autoload.php';

Contributing

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

Contact

Nicola Asuni - [e-mail]