PHPackages                             adt/files - 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. adt/files

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

adt/files
=========

v6.1(7mo ago)027.1k↓44.4%1BSD-3-ClausePHPPHP ^8.4

Since Mar 17Pushed 1mo ago15 watchersCompare

[ Source](https://github.com/AppsDevTeam/Files)[ Packagist](https://packagist.org/packages/adt/files)[ Docs](http://appsdevteam.com)[ RSS](/packages/adt-files/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (4)Versions (46)Used By (1)

Files
=====

[](#files)

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

[](#installation)

`$ composer require adt/files`

- Create instance of `\ADT\Files\Listeners\FileListener` - parameters:
    - `$dataDir` is path to directory where files will be saved
    - `$dataUrl` is URL leading to same directory
    - implementation of `Doctrine\ORM\EntityMangerInterface`
- Register `\ADT\Files\Listeners\FileListener` into `Doctrine\Common\EventManger`. If you are using kdyby ORM extension, you can do that by added tag `kdyby.subscriber` like this: ```
    services:
        -
            factory: ADT\Files\Listeners\FileListener(%dataFolder%/files, 'files')
            tags: [kdyby.subscriber]

    ```
- Create your File entity for example: ```
        use ADT\Files\Entities\IFileEntity;
        use ADT\Files\Entities\TFileEntity;
        use Doctrine\ORM\Mapping as ORM;

        /**
         * @ORM\Entity()
         */
        class File implements IFileEntity
        {

            use TFileEntity;

        }
    ```

    Feel free to add any aditional columns you need and dont forget about id/PK/identifier.

Usage
-----

[](#usage)

```
// create instance of entity
$file = new File();

// set binary data to entity as variable
$file->setTemporaryContent($binaryContentInString, $originalFileName);

// or set path to temporary file, for example after receiving submitted form with file input
$file->setTemporaryFile($pathToTemporaryFile, $originalFileName);

$entityManager->persist($file);
$entityManager->flush();
```

###  Health Score

59

—

FairBetter than 99% of packages

Maintenance78

Regular maintenance activity

Popularity27

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity93

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 78.6% 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 ~81 days

Recently: every ~70 days

Total

44

Last Release

234d ago

Major Versions

1.0.1 → v2.02018-02-19

v2.1 → v3.02018-10-09

v3.0 → v4.02019-10-21

v4.3 → v5.02020-08-08

v5.8.8 → v6.02025-07-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/5575ff5b286a1982356d8ed7d8fc9f44385b44ef1108f34ac8c71b106d0c69ec?d=identicon)[michallohnisky](/maintainers/michallohnisky)

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

---

Top Contributors

[![thorewi](https://avatars.githubusercontent.com/u/605858?v=4)](https://github.com/thorewi "thorewi (66 commits)")[![michallohnisky](https://avatars.githubusercontent.com/u/4747059?v=4)](https://github.com/michallohnisky "michallohnisky (15 commits)")[![Walusyak](https://avatars.githubusercontent.com/u/20837611?v=4)](https://github.com/Walusyak "Walusyak (2 commits)")[![NoxZet](https://avatars.githubusercontent.com/u/23127344?v=4)](https://github.com/NoxZet "NoxZet (1 commits)")

### Embed Badge

![Health badge](/badges/adt-files/health.svg)

```
[![Health](https://phpackages.com/badges/adt-files/health.svg)](https://phpackages.com/packages/adt-files)
```

###  Alternatives

[nette/assets

🎨 Nette Assets: elegant asset management for PHP with versioning, caching and mappers for various storage backends.

41346.6k7](/packages/nette-assets)

PHPackages © 2026

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