flaphl/filesystem

Filesystem abstractions pulled from Flaphl elements.

v1.0.0 2025-10-18 06:01 UTC

Requires

• php: ^8.2

Requires (Dev)

• phpunit/phpunit: ^11.0 || ^12.0

MIT

• Jade Phyressi

• php
• file
• filesystem
• directory
• flaphl

README

Filesystem utilities pulled from Flaphl elements.

Installation

composer require flaphl/filesystem

Features

• Cross-platform compatibility - Works seamlessly on Windows, macOS, and Linux
• Comprehensive file operations - Read, write, copy, move, delete with proper error handling
• Directory management - Create, remove, mirror directories recursively
• Path utilities - Normalize, join, and manipulate file paths safely
• Security features - Path traversal protection and validation
• Exception-driven - Clear error reporting with typed exceptions

Basic Usage

use Flaphl\Element\Filesystem\Filesystem;
use Flaphl\Element\Filesystem\Path;

$fs = new Filesystem();

// Basic file operations
$fs->writeFile('/path/to/file.txt', 'Hello World!');
$content = $fs->readFile('/path/to/file.txt');

// Directory operations
$fs->mkdir('/path/to/directory');
$fs->copy('/source/directory', '/target/directory');

// Path utilities
$normalized = Path::normalize('/path/../to/./file.txt'); // '/to/file.txt'
$joined = Path::join('/base', 'subdir', 'file.txt'); // '/base/subdir/file.txt'