PHPackages                             fluxfiles/fluxfiles - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. fluxfiles/fluxfiles

ActiveLibrary[Authentication & Authorization](/categories/authentication)

fluxfiles/fluxfiles
===================

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

v0.2.54(3w ago)1441MITPHPPHP ^8.1

Since May 30Pushed 1mo agoCompare

[ Source](https://github.com/thai-pc/fluxfiles-core)[ Packagist](https://packagist.org/packages/fluxfiles/fluxfiles)[ Docs](https://github.com/thai-pc/fluxfiles)[ RSS](/packages/fluxfiles-fluxfiles/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (17)Versions (64)Used By (1)

FluxFiles Core (PHP)
====================

[](#fluxfiles-core-php)

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
------------

[](#requirements)

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

Two ways to use FluxFiles
-------------------------

[](#two-ways-to-use-fluxfiles)

FluxFiles is both **a standalone app** and **a Composer library**. Pick the mode that matches what you saw after installing — this is the #1 source of "where did my files go?" confusion.

### A. Standalone app (run the file manager directly)

[](#a-standalone-app-run-the-file-manager-directly)

Download a release / clone the repo, then from the package root:

```
composer install
php -S localhost:8080 router.php
```

Open:

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

### B. Composer dependency (embed in your PHP app)

[](#b-composer-dependency-embed-in-your-php-app)

```
composer require fluxfiles/fluxfiles
```

This installs the package under **`vendor/fluxfiles/fluxfiles/`** — that is correct and expected. The app files (`api/`, `public/`, `embed.php`, …) live there, *not*in your project root, and the autoloader lives in your project's top-level `vendor/`. From your app you autoload the `FluxFiles\` classes and mint tokens via `embed.php`.

To run the **standalone server from an installed dependency**, use the bundled binary (it sets the document root and finds the autoloader for you, in either layout):

```
php vendor/bin/fluxfiles serve --host=127.0.0.1 --port=8080
# → http://127.0.0.1:8080/public/
```

Configuration
-------------

[](#configuration)

Copy this package's [`.env.example`](.env.example) to `.env` (the API loads it from the package root) and set at least:

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

License
-------

[](#license)

MIT — see [LICENSE](LICENSE) for details.

Links
-----

[](#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`

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance92

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

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

Total

63

Last Release

27d ago

PHP version history (2 changes)v1.26.3PHP >=7.4

v1.26.4PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/32d0caeb5c686e7417b8c55fd0f36faff14a9e726c663bff70b84d23193a5db1?d=identicon)[thai-pc](/maintainers/thai-pc)

---

Tags

jwtFlysystems3storagemediauploadfile managerr2

### Embed Badge

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

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

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.7k285.7M1.1k](/packages/league-flysystem-aws-s3-v3)[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k16](/packages/tempest-framework)[azuracast/azuracast

The AzuraCast self-hosted web radio station management suite.

3.9k27.8k](/packages/azuracast-azuracast)[mostafaznv/larupload

Larupload is a ORM based file uploader for laravel to upload image, video, audio and other known files.

75462.1k6](/packages/mostafaznv-larupload)

PHPackages © 2026

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