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

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

vakata/files
============

A collection of file storage classes

3.8.2(3mo ago)06.3k↓78.2%2MITPHPPHP >=7.2.0

Since Apr 28Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/vakata/files)[ Packagist](https://packagist.org/packages/vakata/files)[ Docs](https://github.com/vakata/files)[ RSS](/packages/vakata-files/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependenciesVersions (47)Used By (0)

files
=====

[](#files)

[![Latest Version on Packagist](https://camo.githubusercontent.com/3e96aced2fd9b40a66b63744213c43c010ecf48107c75083397961800cad29b6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f76616b6174612f66696c65732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/vakata/files)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/878d2fd45d399d074e129d7a9cb0f2a4db3163462b6445671bd55b2c7346decc/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f76616b6174612f66696c65732f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/vakata/files)[![Code Climate](https://camo.githubusercontent.com/29cb721effe05d5a01a4657dbe02171ed080d0977f997a2fcd482d89155ab3e2/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636c696d6174652f6769746875622f76616b6174612f66696c65732e7376673f7374796c653d666c61742d737175617265)](https://codeclimate.com/github/vakata/files)[![Tests Coverage](https://camo.githubusercontent.com/06d2973472f476d753f8a0e3075f06e9e8d553e0f93071b3725262078100ce32/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636c696d6174652f636f7665726167652f6769746875622f76616b6174612f66696c65732e7376673f7374796c653d666c61742d737175617265)](https://codeclimate.com/github/vakata/files)

File storage classes.

Install
-------

[](#install)

Via Composer

```
$ composer require vakata/files
```

Usage
-----

[](#usage)

```
// create an instance
$files = new \vakata\files\FileStorage('/path/to/dir');
$file = $files->fromFile('/path/to/existing/file'); // stores the file
$files->get($file['id']); // retrieves the file meta data
$file = $files->fromString('save this string', 'into.file.name');
$files->get($file['id']); // retrieves the file meta data
```

Read more in the [API docs](docs/README.md)

Testing
-------

[](#testing)

```
$ composer test
```

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

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [vakata](https://github.com/vakata)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance80

Actively maintained with recent releases

Popularity23

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 98.2% 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 ~80 days

Recently: every ~39 days

Total

46

Last Release

107d ago

Major Versions

1.4.0 → 2.0.02020-05-04

2.0.0 → 3.0.02020-06-23

PHP version history (2 changes)1.0.0PHP >=5.4.0

2.0.0PHP >=7.2.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/146052?v=4)[Ivan Bozhanov](/maintainers/vakata)[@vakata](https://github.com/vakata)

---

Top Contributors

[![vakata](https://avatars.githubusercontent.com/u/146052?v=4)](https://github.com/vakata "vakata (56 commits)")[![rosenpapazov](https://avatars.githubusercontent.com/u/14393835?v=4)](https://github.com/rosenpapazov "rosenpapazov (1 commits)")

---

Tags

filesvakata

### Embed Badge

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

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

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k679.9M2.5k](/packages/league-flysystem)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.7k285.7M1.0k](/packages/league-flysystem-aws-s3-v3)[league/flysystem-local

Local filesystem adapter for Flysystem.

225267.1M89](/packages/league-flysystem-local)[mikehaertl/php-tmpfile

A convenience class for temporary files

9732.3M21](/packages/mikehaertl-php-tmpfile)[league/flysystem-memory

In-memory filesystem adapter for Flysystem.

8737.3M277](/packages/league-flysystem-memory)[creocoder/yii2-flysystem

The flysystem extension for the Yii framework

2931.7M63](/packages/creocoder-yii2-flysystem)

PHPackages © 2026

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