README

CommonPHP Filesystem provides virtual mount-based filesystem access for CommonPHP applications. It resolves logical paths to one or more real storage locations while keeping file access consistent across applications and packages.

The package gives CommonPHP applications a clean way to work with application storage, package resources, and mounted locations without scattering raw paths throughout the codebase.

Requirements

• PHP ^8.5

Installation

Once this package is available through your Composer repositories, install it with:

composer require comphp/filesystem

Usage

<?php

// TODO: Write usage

Package Notes

This package should own virtual mount points, multiple real locations per mount, file access, path normalization, and storage abstractions. Runtime only provides root-relative path resolution.

Error Handling

Missing mounts, invalid paths, unreadable files, unwritable destinations, and storage failures should throw CommonPHP filesystem exceptions.

Documentation

• Documentation index
• Usage
• Testing
• Contributing
• Security

License

MIT. See LICENSE.md.