PHPackages                             bengor-file/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. bengor-file/file

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

bengor-file/file
================

Lightweight file library developed using Domain-Driven Design

v0.5.3(8y ago)28.2k16MITPHPPHP ^5.5 || ^7.0

Since Mar 18Pushed 8y ago2 watchersCompare

[ Source](https://github.com/BenGorFile/File)[ Packagist](https://packagist.org/packages/bengor-file/file)[ RSS](/packages/bengor-file-file/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (3)Versions (12)Used By (6)

BenGorFile
==========

[](#bengorfile)

> Lightweight file PHP library developed using Domain-Driven Design

[![SensioLabsInsight](https://camo.githubusercontent.com/d668ae1b95b339ba538a8f409a48c7e65c3c2f92af026e488651f22883d7d8eb/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f63363834323136642d633566332d346237302d613763662d3165633261663734333134322f6d696e692e706e67)](https://insight.sensiolabs.com/projects/c684216d-c5f3-4b70-a7cf-1ec2af743142)[![Build Status](https://camo.githubusercontent.com/c5e632cafa8ec408f0cdc959db2ab3ca801d2e7b25b70ab2dbdbbe3fe4dbb86b/68747470733a2f2f7472617669732d63692e6f72672f42656e476f7246696c652f46696c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/BenGorFile/File)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/b25e97add8f499b6d5757d5284681208b2d4c20f83c522135f343f67db20f56d/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f42656e476f7246696c652f46696c652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/BenGorFile/File/?branch=master)[![Total Downloads](https://camo.githubusercontent.com/2d192380e6aeb29b7a7ab1c0e59917135bd7267d30bae95f3b17eef5ecff9119/68747470733a2f2f706f7365722e707567782e6f72672f62656e676f722d66696c652f66696c652f646f776e6c6f616473)](https://packagist.org/packages/bengor-file/file)[![Latest Stable Version](https://camo.githubusercontent.com/7b5524786ac03fdbae82e81079d588ffb53eb347ee622c0ab873ac04b71b25ed/68747470733a2f2f706f7365722e707567782e6f72672f62656e676f722d66696c652f66696c652f762f737461626c652e737667)](https://packagist.org/packages/bengor-file/file)[![Latest Unstable Version](https://camo.githubusercontent.com/bd3811cfa4a19f9763c5af7ebc7ccd29023fdb71ec047d8aca0eea49074d79b2/68747470733a2f2f706f7365722e707567782e6f72672f62656e676f722d66696c652f66696c652f762f756e737461626c652e737667)](https://packagist.org/packages/bengor-file/file)

BenGorFile is **lightweight, flexible and easy to use** file management library. Using **Domain-Driven Design**this library offers a well tested and documented codebase with many common use cases already implemented, such as:

- Upload file
    - Default
    - By hash
- Overwrite file
- Remove file
- Rename file

Requirements
------------

[](#requirements)

PHP >= 5.5

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

[](#installation)

The easiest way to install this component is using [Composer](http://getcomposer.org)

```
$ composer require bengor-file/file
```

Documentation
-------------

[](#documentation)

All the documentation is stored in the `docs` folder.

[Show me the docs!](docs/index.md)

Tests
-----

[](#tests)

This library is completely tested by **[PHPSpec](http://www.phpspec.net/), SpecBDD framework for PHP**.

Run the following command to launch tests:

```
$ vendor/bin/phpspec run -fpretty
```

Contributing
------------

[](#contributing)

This library follows PHP coding standards, so pull requests need to execute the Fabien Potencier's [PHP-CS-Fixer](http://cs.sensiolabs.org/). Furthermore, if the PR creates some not-PHP file remember that you have to put the license header manually. In order to simplify we provide a Composer script that wraps all the commands related with this process.

```
$ composer run-script cs
```

There is also a policy for contributing to this project. Pull requests must be explained step by step to make the review process easy in order to accept and merge them. New methods or code improvements must come paired with [PHPSpec](http://www.phpspec.net/) tests.

If you would like to contribute it is a good point to follow Symfony contribution standards, so please read the [Contributing Code](http://symfony.com/doc/current/contributing/code/index.html) in the project documentation. If you are submitting a pull request, please follow the guidelines in the [Submitting a Patch](http://symfony.com/doc/current/contributing/code/patches.html#check-list) section and use the [Pull Request Template](http://symfony.com/doc/current/contributing/code/patches.html#make-a-pull-request).

Credits
-------

[](#credits)

This library is created by:

>

**@benatespina** -
**@gorkalaucirica** -

Licensing Options
-----------------

[](#licensing-options)

[![License](https://camo.githubusercontent.com/9cdb8d11be73becf8d9e22532180c6646569b0e8606befcb34e022a6efdade36/68747470733a2f2f706f7365722e707567782e6f72672f62656e676f722d66696c652f66696c652f6c6963656e73652e737667)](https://github.com/BenGorFile/File/blob/master/LICENSE)

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~69 days

Recently: every ~35 days

Total

11

Last Release

3064d ago

PHP version history (2 changes)v0.1.0PHP ^5.5|^7.0

v0.2.0PHP ^5.5 || ^7.0

### Community

Maintainers

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

![](https://www.gravatar.com/avatar/06308bfc15d8774c16d36d727f852c2d29ed8d0d6153637384439747776dc658?d=identicon)[benatespina](/maintainers/benatespina)

---

Top Contributors

[![benatespina](https://avatars.githubusercontent.com/u/3951376?v=4)](https://github.com/benatespina "benatespina (59 commits)")

---

Tags

filecomponentddd

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/bengor-file-file/health.svg)

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

###  Alternatives

[google/cloud-storage

Cloud Storage Client for PHP

34899.5M148](/packages/google-cloud-storage)[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

190185.4k17](/packages/fof-upload)[xi/filelib

File library for PHP

2254.5k2](/packages/xi-filelib)[reshadman/file-secretary

Get rid of anything related to files in Laravel, This package handles all for you. Anything we mean.

1131.8k](/packages/reshadman-file-secretary)

PHPackages © 2026

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