PHPackages                             ghostwriter/filesystem - 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. ghostwriter/filesystem

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

ghostwriter/filesystem
======================

Filesystem implementation for PHP

0.2.1(2w ago)03.7M↑45.8%14BSD-3-ClausePHPPHP ~8.4.0 || ~8.5.0 || ~8.6.0CI passing

Since Oct 8Pushed 1w ago1 watchersCompare

[ Source](https://github.com/ghostwriter/filesystem)[ Packagist](https://packagist.org/packages/ghostwriter/filesystem)[ Docs](https://github.com/ghostwriter/filesystem)[ GitHub Sponsors](https://github.com/sponsors/ghostwriter)[ Fund](https://paypal.me/codepoet)[ RSS](/packages/ghostwriter-filesystem/feed)WikiDiscussions 0.2.x Synced 3d ago

READMEChangelog (5)Dependencies (18)Versions (60)Used By (14)

Filesystem
==========

[](#filesystem)

[![Automation](https://github.com/ghostwriter/filesystem/actions/workflows/automation.yml/badge.svg)](https://github.com/ghostwriter/filesystem/actions/workflows/automation.yml)[![PHP Version](https://camo.githubusercontent.com/2251431e75964806252ad58cab1640971e4c0f7dd51308c11db7918cb067f31b/68747470733a2f2f62616467656e2e6e65742f7061636b61676973742f7068702f67686f73747772697465722f66696c6573797374656d3f636f6c6f723d373737424234)](https://www.php.net/supported-versions)[![Packagist Downloads](https://camo.githubusercontent.com/cca6f142ad858fd4014d3566bb313f4c6a76548638eeecfce99f9f3bf3629e7d/68747470733a2f2f62616467656e2e6e65742f7061636b61676973742f64742f67686f73747772697465722f66696c6573797374656d3f636f6c6f723d463238443141)](https://packagist.org/packages/ghostwriter/filesystem)[![PayPal](https://camo.githubusercontent.com/1efa90a77ba349664622c6961afafb52d3aaa44e609dfe3f3e262c7634f29efd/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70617970616c2d40636f6465706f65742d3030373943313f6c6f676f3d64617461253341696d616765253246737667253242786d6c25334262617365363425324350484e325a79423261575633516d393450534977494441674d6a51674d6a5169494868746247357a50534a6f644852774f693876643364334c6e637a4c6d39795a7938794d4441774c334e325a794925324250484268644767675a443069545445354c6a63784e5341324c6a457a4d324d754d6a51354c5445754f445932494441744d7934784d5330754f546b354c5451754d6a5932517a45334c6a597a4e4334324d6a49674d5455754e7a4978494441674d544d754d7a4133494442494e6934794d7a566a4c5334304d5467674d4330754f5445324c6a51304e433078494334344f446c4d4d69347a4d6a4d674d6a41754e6a4979597a41674c6a4d314e6934794e5334344c6a59324e533434614451754d7a4934624330754d6a55674d5334354e545a6a4c5334774f4451754d7a55314c6a45324e6934324d6a49754e446b344c6a59794d6d677a4c6a59324d324d754e444533494441674c6a677a4d6930754d6a59334c6a6b784e5330754e7a4578646930754d6a5933624334334e446b744e4334324d6a4a324c5334784e7a686a4c6a41344d7930754e4451304c6a55744c6a67754f5445314c53343461433431597a4d754e546334494441674e69347a4d6a55744d5334314d5341334c6a45314e6930314c6a6b314e5334304d5467744d5334344e6a63754d6a55794c544d754d7a63344c5334334e4463744e4334304e4455744c6a49314c53347a4e5455744c6a59324e6930754e6a49794c5445744c6a67344f5349675a6d6c7362443069497a41774f574e6b5a534976506a78775958526f49475139496b30784f5334334d5455674e6934784d7a4e6a4c6a49304f5330784c6a67324e6941774c544d754d5445744c6a6b354f5330304c6a49324e6b4d784e7934324d7a51754e6a4979494445314c6a63794d5341774944457a4c6a4d774e794177534459754d6a4d31597930754e444534494441744c6a6b784e6934304e4451744d5341754f446735544449754d7a497a494449774c6a59794d6d4d774943347a4e5459754d6a55754f4334324e6a55754f4767304c6a4d794f4777784c6a45324e4330334c6a4d334f4330754d44677a4c6a49324e324d754d4467304c5334314d7a4d754e5330754f4467354c6a6b354f4330754f446735614449754d44686a4e4334774e7a6b674d4341334c6a49304d5330784c6a63334f4341344c6a49304c5459754e7a55314c5334774f444d744c6a49324e7941774c53347a4e5459674d4330754e544d304969426d615778735053496a4d4445794d54593549693825324250484268644767675a44306954546b754e54597a494459754d544d7a597934774f4449744c6a49324e6934794e5330754e544d7a4c6a51354f4330754e7a45754d545932494441674c6a49314c5334774f5334304d5459744c6a4135614455754e446b30597934324e6a59674d4341784c6a4d7a4c6a4135494445754f444d754d5463344c6a45324e6941774943347a4d7a4d674d4341754e446b344c6a41344f5334784e6a67754d4467354c6a4d7a4e4334774f446b754e4445344c6a45334f4767754d6a566a4c6a49304f4334774f446b754e446b334c6a49324e6934334e4467754d7a55314c6a49304f4330784c6a67324e6941774c544d754d5445744c6a6b354f5330304c6a4d314e554d784e7934334d5463754e544d7a494445314c6a67774e4341774944457a4c6a4d35494442494e6934794d7a566a4c5334304d5467674d4330754f5445324c6a4d314e693078494334344f446c4d4d69347a4d6a4d674d6a41754e6a4979597a41674c6a4d314e6934794e5334344c6a59324e533434614451754d7a4934624445754d5459304c5463754d7a6334494445754d4467304c5463754f5446364969426d615778735053496a4d44417a4d4467334969382532425043397a646d63253242)](https://paypal.me/codepoet)[![Sponsors via GitHub](https://camo.githubusercontent.com/36bfc05d57d9eb86d7f11e8b1ca2b7068192040bb3bf194473f49761f0dc1f3a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73706f6e736f72732f67686f73747772697465723f6c6162656c3d53706f6e736f722b4067686f73747772697465722f66696c6573797374656d266c6f676f3d4769744875622b53706f6e736f7273)](https://github.com/sponsors/ghostwriter)

Filesystem implementation for PHP

Warning

This project is not finished yet, work in progress.

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

[](#installation)

You can install the package via composer:

```
composer require ghostwriter/filesystem
```

### Star ⭐️ this repo if you find it useful

[](#star-️-this-repo-if-you-find-it-useful)

You can also star (🌟) this repo to find it easier later.

Usage
-----

[](#usage)

```
use GhostWriter\Filesystem\Filesystem;

$filesystem = new Filesystem();

$currentDirectory = $filesystem->currentWorkingDirectory();

$filesystem->write($currentDirectory . '/blm.txt', '#BlackLivesMatter');

$content = $filesystem->read($currentDirectory . '/blm.txt');

echo $content; // #BlackLivesMatter
```

### Credits

[](#credits)

- [Nathanael Esayeas](https://github.com/ghostwriter)
- [All Contributors](https://github.com/ghostwriter/filesystem/contributors)

### Changelog

[](#changelog)

Please see [CHANGELOG.md](./CHANGELOG.md) for more information on what has changed recently.

### License

[](#license)

Please see [LICENSE](./LICENSE) for more information on the license that applies to this project.

### Security

[](#security)

Please see [SECURITY.md](./SECURITY.md) for more information on security disclosure process.

###  Health Score

58

—

FairBetter than 98% of packages

Maintenance97

Actively maintained with recent releases

Popularity42

Moderate usage in the ecosystem

Community17

Small or concentrated contributor base

Maturity61

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

Recently: every ~17 days

Total

9

Last Release

12d ago

Major Versions

0.3.x-dev → 1.0.x-dev2026-06-05

PHP version history (3 changes)0.1.0PHP >=8.3

0.1.2PHP ~8.4.0 || ~8.5.0

0.3.x-devPHP ~8.4.0 || ~8.5.0 || ~8.6.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/1dbb0131801cc451dad9917ab29aa823b25d7eebc9f3875a9d481d109bdb44ee?d=identicon)[ghostwriter](/maintainers/ghostwriter)

---

Top Contributors

[![ghostwriter](https://avatars.githubusercontent.com/u/9754361?v=4)](https://github.com/ghostwriter "ghostwriter (1620 commits)")

---

Tags

filesystemghostwriterfilesystemghostwriter

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ghostwriter-filesystem/health.svg)

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

###  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)[knplabs/gaufrette

PHP library that provides a filesystem abstraction layer

2.5k41.5M133](/packages/knplabs-gaufrette)[knplabs/knp-gaufrette-bundle

Allows to easily use the Gaufrette library in a Symfony project

72430.0M104](/packages/knplabs-knp-gaufrette-bundle)[league/flysystem-local

Local filesystem adapter for Flysystem.

225267.1M89](/packages/league-flysystem-local)[oneup/flysystem-bundle

Integrates Flysystem filesystem abstraction library to your Symfony project.

65223.8M81](/packages/oneup-flysystem-bundle)

PHPackages © 2026

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