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

AbandonedArchivedLibrary

hgraca/file-system
==================

A generic PHP library that wraps file system calls.

1.3.0(9y ago)01332MITPHPPHP >=7.0

Since Nov 20Pushed 9y ago1 watchersCompare

[ Source](https://github.com/hgraca/php-file-system)[ Packagist](https://packagist.org/packages/hgraca/file-system)[ RSS](/packages/hgraca-file-system/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (10)Dependencies (4)Versions (12)Used By (2)

Hgraca\\FileSystem
==================

[](#hgracafilesystem)

[![Author](https://camo.githubusercontent.com/e80528a6fbd7a1766b221b1a32d700b339f6a1992a8e0a1f602d24c256c74d66/687474703a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d406867726163612d626c75652e7376673f7374796c653d666c61742d737175617265)](https://www.herbertograca.com)[![Software License](https://camo.githubusercontent.com/942e017bf0672002dd32a857c95d66f28c5900ab541838c6c664442516309c8a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Latest Version](https://camo.githubusercontent.com/c8ee8dcad5d1b1a68bc34b5256093e2be99f11b50ecd68db8eaf23276940ff32/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6867726163612f7068702d66696c652d73797374656d2e7376673f7374796c653d666c61742d737175617265)](https://github.com/hgraca/php-file-system/releases)[![Total Downloads](https://camo.githubusercontent.com/19c960c12b706ce7382b5aa52c4f4742e65c7c905b139e6e5cc2fa6dff7ca9a8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6867726163612f66696c652d73797374656d2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/hgraca/file-system)

[![Build Status](https://camo.githubusercontent.com/4ff1eef960d317963cf82963dd38278447747af6449ebe16c1f0d6995f8eb580/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f6275696c642f672f6867726163612f7068702d66696c652d73797374656d2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/hgraca/php-file-system/build)[![Coverage Status](https://camo.githubusercontent.com/1bd30ab1589c012e9ca4a9d652e8b9aaaaa5704d76d8b24d3e86ec0fcbf27f3f/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f6867726163612f7068702d66696c652d73797374656d2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/hgraca/php-file-system/code-structure)[![Quality Score](https://camo.githubusercontent.com/652d224d1ee6778247fc1dec1999ad9ef37ba328cc08df976ea403598717a89f/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6867726163612f7068702d66696c652d73797374656d2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/hgraca/php-file-system)

A generic library that wraps file system calls. It contains an in-memory file system that behaves the same as the real one, very useful for testing applications that use this little wrapper class.

Please note that this is only useful for small files in a local file system.

- If you need to handle big files, you should use streams.
- If you need to use files from multiple file systems (local, S3, RedShift, ...) I advise using [FlySystem](https://flysystem.thephpleague.com/).

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

[](#installation)

To install the library, run the command below and you will get the latest version:

```
composer require hgraca/file-system

```

Usage
-----

[](#usage)

Simply instantiate one of the concrete classes and use.

There are 2 modes:

- Strict: ie, If we try to delete a folder that does not exist, it throws an exception
- Idempotent: ie, If we try to delete a folder that does not exist, it DOES NOT throw an exception

Todo
----

[](#todo)

- Change structure from inheritance into composition

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity65

Established project with proven stability

 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 ~4 days

Recently: every ~9 days

Total

11

Last Release

3418d ago

Major Versions

0.1.0 → 1.0.02016-11-25

### Community

Maintainers

![](https://www.gravatar.com/avatar/4af14428505ab93e698bb1fa7a540b0f71dbae0246b6c534f39011aaafc13717?d=identicon)[hgraca](/maintainers/hgraca)

---

Top Contributors

[![hgraca](https://avatars.githubusercontent.com/u/1809002?v=4)](https://github.com/hgraca "hgraca (22 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

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

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

PHPackages © 2026

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