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

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

matraux/filesystem
==================

A PHP 8.4+ library for object-oriented file and folder manipulation with support for PSR-7 and Nette\\Http\\FileUpload.

3.0.0(2mo ago)02762MITPHPPHP ^8.4CI passing

Since Mar 12Pushed 2mo agoCompare

[ Source](https://github.com/matraux/filesystem)[ Packagist](https://packagist.org/packages/matraux/filesystem)[ RSS](/packages/matraux-filesystem/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (14)Versions (14)Used By (2)

MATRAUX File System
===================

[](#matraux-file-system)

[![Latest Version on Packagist](https://camo.githubusercontent.com/8000ecbb8ebdfee390e37a55cefbb7d937a398647efc576fbd35a40cb0d710e8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6174726175782f66696c6573797374656d2e7376673f6c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/matraux/filesystem)[![Last release](https://camo.githubusercontent.com/0c1640cccfc0e1cd219b5bf7d48c39d38f1faf4a7ecff73ded6bd6e64528c130/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f6d6174726175782f66696c6573797374656d3f646973706c61795f6e616d653d746167266c6f676f3d676974687562266c6f676f436f6c6f723d7768697465)](https://github.com/matraux/filesystem/releases)[![License: MIT](https://camo.githubusercontent.com/aaaf7fce1d44e884300a55df2c82406f416bc1e5009859d78aedbb69249e4611/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e7376673f6c6f676f3d6f70656e2d736f757263652d696e6974696174697665266c6f676f436f6c6f723d7768697465)](LICENSE)[![PHP](https://camo.githubusercontent.com/2b0538729bedffcc119589c18037b4ebcff0f4d71a1d4320d4904f72dda5810f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342b2d626c75652e7376673f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://php.net)[![Security Policy](https://camo.githubusercontent.com/33427022d3760656f0ff395d8f48f1230d42ba200881fbcc019aabadf2ffabe8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53656375726974792d506f6c6963792d626c75653f6c6f676f3d62697477617264656e266c6f676f436f6c6f723d7768697465)](./.github/SECURITY.md)[![Contributing](https://camo.githubusercontent.com/bd7eaa3d90ef7ad126e208b3b8adf606e0805b6e28c8c38aa16d52fb38ac7fb5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e747269627574696e672d44697361626c65642d6c69676874677265793f6c6f676f3d676974687562266c6f676f436f6c6f723d7768697465)](CONTRIBUTING.md)[![QA Status](https://camo.githubusercontent.com/e792cf31e756087f65aee5ea7233bdf886fea2fa8c3260fc91e222982dc128e9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d6174726175782f66696c6573797374656d2f71612e796d6c3f6c6162656c3d5175616c6974792b4173737572616e6365266c6f676f3d636865636b6d617278266c6f676f436f6c6f723d7768697465)](https://github.com/matraux/filesystem/actions/workflows/qa.yml)[![Issues](https://camo.githubusercontent.com/d1781f12a52ca76d097f82e13952c445e1dbdec2f860dfb279f53d3e9b713c84/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6d6174726175782f66696c6573797374656d3f6c6f676f3d676974687562266c6f676f436f6c6f723d7768697465)](https://github.com/matraux/filesystem/issues)[![Last Commit](https://camo.githubusercontent.com/5b946fa5b89684acd2a359deb59a847c02e1a6df6273858d0448394a0d09fb26/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f6d6174726175782f66696c6573797374656d3f6c6f676f3d676974266c6f676f436f6c6f723d7768697465)](https://github.com/matraux/filesystem/commits)

Introduction
------------

[](#introduction)

A PHP 8.4+ library that simplifies file and folder operations using an object-oriented API. Supports renaming, moving, streaming, and deletion with optional integration for PSR-7 and Nette\\Http\\FileUpload.

Features
--------

[](#features)

- File and folder manipulation with fluent API
- Relative and absolute path resolution
- File iteration via chunks (stream-style)
- Automatic cleanup of temporary files
- PSR-7 stream support `Psr\Http\Message\StreamInterface`
- Nette FileUpload support `Nette\Http\FileUpload`
- Easy extension via inheritance

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

[](#installation)

```
composer require matraux/filesystem
```

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

[](#requirements)

versionPHPNote1.0.07.4+Support PHP 7.42.0.08.3+Support PHP 8.33.0.08.4+Support PHP 8.4
Examples
--------

[](#examples)

See [File](./docs/File.md) for advanced instructions.

```
use Matraux\FileSystem\File\File;

$file = File::fromPath('C:\Users\MATRAUX\Webs\Resources\FileSystem\log.txt');
echo $file->name;  // "log.txt"
```

See [Folder](./docs/Folder.md) for advanced instructions.

```
use Matraux\FileSystem\Folder\Folder;

$folder = Folder::fromPath()->addPath('backup');
echo $folder->absolute; // "C:\Users\MATRAUX\Webs\Resources\FileSystem\backup"
```

Development
-----------

[](#development)

See [Development](./docs/Development.md) for debug, test instructions, static analysis, and coding standards.

Support
-------

[](#support)

For bug reports and feature requests, please use the [issue tracker](https://github.com/matraux/filesystem/issues).

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance86

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity58

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

Recently: every ~32 days

Total

13

Last Release

67d ago

Major Versions

1.3.1 → 3.0.02026-03-12

PHP version history (3 changes)1.1.0PHP ^8.4

2.0.0PHP ^8.3

1.0.0PHP ^7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/5de8dde6b301108e289df5793632663794646f600ad72d94597c78ecba7408ed?d=identicon)[matraux](/maintainers/matraux)

---

Top Contributors

[![matraux](https://avatars.githubusercontent.com/u/46919973?v=4)](https://github.com/matraux "matraux (110 commits)")

---

Tags

filesystemfile systemMATRAUX

###  Code Quality

TestsCodeception

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k639.1M2.2k](/packages/league-flysystem)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[knplabs/gaufrette

PHP library that provides a filesystem abstraction layer

2.5k39.8M123](/packages/knplabs-gaufrette)[knplabs/knp-gaufrette-bundle

Allows to easily use the Gaufrette library in a Symfony project

72528.6M91](/packages/knplabs-knp-gaufrette-bundle)[league/flysystem-local

Local filesystem adapter for Flysystem.

226231.8M39](/packages/league-flysystem-local)[league/flysystem-bundle

Symfony bundle integrating Flysystem into Symfony applications

40029.5M87](/packages/league-flysystem-bundle)

PHPackages © 2026

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