PHPackages                             tecnickcom/tc-lib-file - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. tecnickcom/tc-lib-file

ActiveLibrary[File & Storage](/categories/file-storage)

tecnickcom/tc-lib-file
======================

PHP library to read byte-level data from files

2.3.1(2mo ago)8776.2k—10%43LGPL-3.0-or-laterPHPPHP >=8.1CI passing

Since Jul 29Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/tecnickcom/tc-lib-file)[ Packagist](https://packagist.org/packages/tecnickcom/tc-lib-file)[ Docs](http://www.tecnick.com)[ Fund](https://www.paypal.com/donate/?hosted_button_id=NZUEC5XS8MFBJ)[ RSS](/packages/tecnickcom-tc-lib-file/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (5)Versions (107)Used By (3)

tc-lib-file
===========

[](#tc-lib-file)

*PHP library to read byte-level file data*

[![Latest Stable Version](https://camo.githubusercontent.com/107c4a73df2f64c221fe8fb8d37042d7b707b8900d968de2562ee874c94765cc/68747470733a2f2f706f7365722e707567782e6f72672f7465636e69636b636f6d2f74632d6c69622d66696c652f76657273696f6e)](https://packagist.org/packages/tecnickcom/tc-lib-file)[![Build](https://github.com/tecnickcom/tc-lib-file/actions/workflows/check.yml/badge.svg)](https://github.com/tecnickcom/tc-lib-file/actions/workflows/check.yml/badge.svg)[![Coverage](https://camo.githubusercontent.com/15306aad5242f61b4bb83cde9d506d62b07506f477feafd046f0f9c33f37590e/68747470733a2f2f636f6465636f762e696f2f67682f7465636e69636b636f6d2f74632d6c69622d66696c652f67726170682f62616467652e7376673f746f6b656e3d695a39736e77676b5541)](https://codecov.io/gh/tecnickcom/tc-lib-file)[![License](https://camo.githubusercontent.com/dd6cd578762e6de1e78a568bcd3d9d22eef8bd79e8ab37df246e91c21edf725c/68747470733a2f2f706f7365722e707567782e6f72672f7465636e69636b636f6d2f74632d6c69622d66696c652f6c6963656e7365)](https://packagist.org/packages/tecnickcom/tc-lib-file)[![Downloads](https://camo.githubusercontent.com/949c0f66a3b78764327f485749b48ef0a48b4ab899848ec25c049626d61639d9/68747470733a2f2f706f7365722e707567782e6f72672f7465636e69636b636f6d2f74632d6c69622d66696c652f646f776e6c6f616473)](https://packagist.org/packages/tecnickcom/tc-lib-file)

[![Donate via PayPal](https://camo.githubusercontent.com/e5f561f4f549822da3fbfb75d0be9059a60eac15b1ff7af66500ca1dd4dba91b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d70617970616c2d3837636565622e737667)](https://www.paypal.com/donate/?hosted_button_id=NZUEC5XS8MFBJ)*Please consider supporting this project by making a donation via [PayPal](https://www.paypal.com/donate/?hosted_button_id=NZUEC5XS8MFBJ)*

- **category** Library
- **package** \\Com\\Tecnick\\File
- **author** Nicola Asuni
- **copyright** 2015-2026 Nicola Asuni - Tecnick.com LTD
- **license**  GNU-LGPL v3 (see LICENSE.TXT)
- **link**
- **SRC DOC**

Description
-----------

[](#description)

This library includes utility classes to read byte-level data.

The initial source code has been derived from [TCPDF](http://www.tcpdf.org).

Getting started
---------------

[](#getting-started)

First, you need to install all development dependencies using [Composer](https://getcomposer.org/):

```
$ curl -sS https://getcomposer.org/installer | php
$ mv composer.phar /usr/local/bin/composer
```

This project include a Makefile that allows you to test and build the project with simple commands. To see all available options:

```
make help
```

To install all the development dependencies:

```
make deps
```

Running all tests
-----------------

[](#running-all-tests)

Before committing the code, please check if it passes all tests using

```
make qa
```

All artifacts are generated in the target directory.

Example
-------

[](#example)

Examples are located in the `example` directory.

Start a development server (requires PHP 8.0+) using the command:

```
make server

```

and point your browser to

Installation
------------

[](#installation)

Create a composer.json in your projects root-directory:

```
{
    "require": {
        "tecnickcom/tc-lib-file": "^2.0"
    }
}
```

Or add to an existing project with:

```
composer require tecnickcom/tc-lib-file ^2.0
```

Packaging
---------

[](#packaging)

This library is mainly intended to be used and included in other PHP projects using Composer. However, since some production environments dictates the installation of any application as RPM or DEB packages, this library includes make targets for building these packages (`make rpm` and `make deb`). The packages are generated under the `target` directory.

When this library is installed using an RPM or DEB package, you can use it your code by including the autoloader:

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

```

Developer(s) Contact
--------------------

[](#developers-contact)

\*2026 Nicola Asuni

###  Health Score

65

—

FairBetter than 99% of packages

Maintenance87

Actively maintained with recent releases

Popularity45

Moderate usage in the ecosystem

Community21

Small or concentrated contributor base

Maturity88

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 97.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~36 days

Recently: every ~8 days

Total

106

Last Release

84d ago

Major Versions

1.7.39 → 2.0.62023-11-05

PHP version history (4 changes)1.0.0PHP >=5.3.3

1.2.0PHP >=5.4

2.0.6PHP >=8.0

2.1.2PHP >=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/f8ee10615840cb28715139809c13ec322d1ccd902506b090469702e5b9d7b88e?d=identicon)[nicolaasuni](/maintainers/nicolaasuni)

---

Top Contributors

[![nicolaasuni](https://avatars.githubusercontent.com/u/1186996?v=4)](https://github.com/nicolaasuni "nicolaasuni (175 commits)")[![jmleroux](https://avatars.githubusercontent.com/u/1516770?v=4)](https://github.com/jmleroux "jmleroux (2 commits)")[![mklemarczyk](https://avatars.githubusercontent.com/u/2727261?v=4)](https://github.com/mklemarczyk "mklemarczyk (1 commits)")[![valioDOTch](https://avatars.githubusercontent.com/u/800467?v=4)](https://github.com/valioDOTch "valioDOTch (1 commits)")

---

Tags

filereadDoubleshortbytebitlongtc-lib-file

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/tecnickcom-tc-lib-file/health.svg)

```
[![Health](https://phpackages.com/badges/tecnickcom-tc-lib-file/health.svg)](https://phpackages.com/packages/tecnickcom-tc-lib-file)
```

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k639.1M2.2k](/packages/league-flysystem)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[knplabs/gaufrette

PHP library that provides a filesystem abstraction layer

2.5k39.8M123](/packages/knplabs-gaufrette)[knplabs/knp-gaufrette-bundle

Allows to easily use the Gaufrette library in a Symfony project

72428.6M91](/packages/knplabs-knp-gaufrette-bundle)[league/flysystem-local

Local filesystem adapter for Flysystem.

225231.8M39](/packages/league-flysystem-local)[adlawson/vfs

Virtual file system

300433.0k21](/packages/adlawson-vfs)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)