innmind/filesystem

Filesystem abstraction layer

8.1.0 2025-05-09 13:05 UTC

Requires

• php: ~8.2
• innmind/immutable: ~4.15|~5.0
• innmind/io: ^3.0.1
• innmind/media-type: ~2.1
• innmind/url: ~4.2
• innmind/validation: ~2.0
• psr/log: ~3.0
• symfony/filesystem: ~6.0|~7.0

Requires (Dev)

• innmind/black-box: ^6.0.2
• innmind/coding-standard: ~2.0
• innmind/static-analysis: ^1.2.1
• ramsey/uuid: ^4.6

Suggests

• innmind/black-box: For property based testing

Provides

• innmind/black-box-sets: 6.0

Conflicts

• innmind/black-box: <6.0|~7.0

MIT

• Baptiste Langlade

• filesystem

README

Filesystem abstraction layer, the goal is to provide a model where you design how you put your files into directories without worrying where it will be persisted.

Documentation

Installation

composer install innmind/filesystem

Usage

The whole model is structured around files, directories, contents and adapters. File, Directory and Content are immutable objects.

Example:

use Innmind\Filesystem\{
    File,
    File\Content,
    Directory,
    Adapter\Filesystem,
};
use Innmind\Url\Path;

$directory = Directory::named('uploads')->add(
    File::named(
        $_FILES['my_upload']['name'],
        Content::ofString(\file_get_contents($_FILES['my_upload']['tmp_name'])),
    ),
);
$adapter = Filesystem::mount(Path::of('/var/www/web/'));
$_ = $adapter
    ->add($directory)
    ->unwrap();

This example show you how you can create a new directory uploads in the folder /var/www/web/ of your filesystem and create the uploaded file into it.

Note: For performance reasons the filesystem adapter only persist to disk the files that have changed (achievable via the immutable nature of file objects).

All adapters implements Adapter, so you can easily replace them; especially for unit tests, that's why the library comes with an InMemory adapter that only keeps the files into memory so you won't mess up your file system.