fluxfiles/fluxfiles

Standalone PHP file manager with multi-storage support (Local/S3/R2)

v1.27.1 2026-04-14 02:57 UTC

Requires

• php: ^8.1
• firebase/php-jwt: ^6.0
• intervention/image: ^3.0
• league/flysystem: ^3.0
• league/flysystem-aws-s3-v3: ^3.0
• vlucas/phpdotenv: ^5.0

MIT

• thai-pc

• media
• storage
• s3
• upload
• jwt
• file-manager
• Flysystem
• r2

README

Core PHP engine for FluxFiles — a standalone, embeddable file manager with multi-storage support (Local/S3/R2) via Flysystem v3.

This package provides:

• API router (api/index.php)
• Core classes (api/*.php)
• UI assets (assets/, public/)
• Translations (lang/)
• Helper functions (embed.php)

Requirements

• PHP >= 8.1 (Flysystem 3 + Intervention Image v3)
• Composer >= 2

Install (Composer)

composer require fluxfiles/fluxfiles

Local development (built-in server)

From this package directory:

php -S localhost:8080 router.php

Open:

• UI: http://localhost:8080/public/index.html
• API: http://localhost:8080/api/fm/list?disk=local&path=

Configuration

Copy .env.example from the monorepo root (../../.env.example when working inside this package) and set at least:

FLUXFILES_SECRET=your-random-secret-key-min-32-chars
FLUXFILES_ALLOWED_ORIGINS=http://localhost:3000,http://localhost:8080

Links

• Main repository: https://github.com/thai-pc/fluxfiles
• Laravel adapter: https://packagist.org/packages/fluxfiles/laravel
• Issues: https://github.com/thai-pc/fluxfiles/issues