PHPackages                             iriven/fluxon - 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. [API Development](/categories/api)
4. /
5. iriven/fluxon

ActiveLibrary[API Development](/categories/api)

iriven/fluxon
=============

Fluxon is a PHP form engine for headless, frontend, runtime, and distributed form workflows.

v6.5.0-stable(1mo ago)00MITPHPPHP ^8.2CI passing

Since Apr 14Pushed 1mo agoCompare

[ Source](https://github.com/irivengroup/fluxon)[ Packagist](https://packagist.org/packages/iriven/fluxon)[ RSS](/packages/iriven-fluxon/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (5)Versions (29)Used By (0)

[![LOGO](https://github.com/irivengroup/assets/raw/main/img/fluxon.png)](https://github.com/irivengroup/fluxon)

 **Fluxon PHP Form Engine. Limitless Possibilities.**

 A modern, extensible, and production-ready PHP form engine for building forms, APIs, and distributed systems.

[![Build Status](https://camo.githubusercontent.com/0f6553ccbbfd99c3dd5d140c28eb07a0c3e85ab6f948b5fc091b27b26f126806/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f69726976656e67726f75702f666c75786f6e2f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/irivengroup/fluxon/build-status/master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/6e33d7ef5d8e68f86a2f09d8ba7f36faa720d381d569fddbb0679060ec5677e3/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f69726976656e67726f75702f666c75786f6e2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/irivengroup/fluxon/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/d300e9619f9abbfe3624b6b0b9e599858268916bd5bcde561d08acfd9974d898/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f69726976656e67726f75702f666c75786f6e2f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/irivengroup/fluxon/?branch=master)[![Code Intelligence Status](https://camo.githubusercontent.com/343c8d787332571bd57a64c26bff064a826631795284cded9f1e5bf7b555e6fe/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f69726976656e67726f75702f666c75786f6e2f6261646765732f636f64652d696e74656c6c6967656e63652e7376673f623d6d6173746572)](https://scrutinizer-ci.com/code-intelligence)[![Latest Version](https://camo.githubusercontent.com/0721b0413f4815a2f7eb27f6b314b4dbd8e96d0679de03805faf9fbc1e52259e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f69726976656e2f666c75786f6e)](https://packagist.org/packages/iriven/fluxon)[![Downloads](https://camo.githubusercontent.com/3f0f5ba800146142d2c63642e4e65f1b744fe4fef7c85b7e136441110b8d890b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f69726976656e2f666c75786f6e)](https://packagist.org/packages/iriven/fluxon)[![PHP Version](https://camo.githubusercontent.com/187240af044d09d5b14a1d9d9ebdf3f7a993e4c7bc09bdb46b4ba661a891bf5b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c7565)](#)[![Status](https://camo.githubusercontent.com/f3adeea933a64c2014c89092040b8c02f4931f3f5a5d46a189133d4ac21d0ebf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374617475732d737461626c652d627269676874677265656e)](#)[![License](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)](#)

---

🚀 What is Fluxon?
-----------------

[](#-what-is-fluxon)

**Fluxon** is a next-generation **PHP Form Engine** designed for modern architectures:

- Headless applications
- API-first systems
- Microservices & distributed environments
- Frontend-driven UIs (React, Vue, etc.)

It allows you to **define forms once and use them everywhere**.

---

✨ Key Features
--------------

[](#-key-features)

### 🧱 Form Definition Engine

[](#-form-definition-engine)

- Define forms using PHP arrays, DTOs, or objects
- Automatic schema generation
- Built-in validation support

### 🎯 Frontend SDK (JSON-first)

[](#-frontend-sdk-json-first)

- Unified schema output
- UI component abstraction
- Multi-channel rendering

### ⚙️ Runtime Engine

[](#️-runtime-engine)

- Synchronous execution
- Context-aware processing
- Fully decoupled architecture

### 🧵 Async Processing (Queue-ready)

[](#-async-processing-queue-ready)

- Job dispatching
- Serializable execution context
- Queue transport abstraction (Redis/SQS-ready)

### 🔌 Plugin Ecosystem (V7+)

[](#-plugin-ecosystem-v7)

- Official plugins (CSRF, Captcha, Upload, etc.)
- Custom plugin support
- Stable plugin contracts

### 📡 Headless Mode

[](#-headless-mode)

- Pure validation engine
- API-ready responses
- No UI dependency

### 📊 Observability & Diagnostics

[](#-observability--diagnostics)

- Runtime profiling
- Production diagnostics
- Debug CLI tools

---

📦 Installation
--------------

[](#-installation)

```
composer require iriven/fluxon
```

---

⚡ Quick Start
-------------

[](#-quick-start)

### Define a form

[](#define-a-form)

```
use Iriven\Fluxon\Domain\Form\Form;

$form = new Form('contact', [
    'email' => ['type' => 'email'],
    'message' => ['type' => 'textarea'],
]);
```

---

### Generate frontend schema

[](#generate-frontend-schema)

```
use Iriven\Fluxon\Application\Frontend\FrontendSdk;

$sdk = new FrontendSdk();
$schema = $sdk->build($form);
```

---

### Headless validation

[](#headless-validation)

```
use Iriven\Fluxon\Application\Headless\HeadlessFormProcessor;

$processor = new HeadlessFormProcessor();

$result = $processor->submit($form, [
    'email' => 'john@example.com',
    'message' => 'Hello'
]);
```

---

### Async dispatch

[](#async-dispatch)

```
use Iriven\Fluxon\Application\Runtime\AsyncRuntimeDispatcher;

$dispatcher = new AsyncRuntimeDispatcher();

$result = $dispatcher->dispatch(
    'submit',
    'contact',
    ['email' => 'john@example.com']
);
```

---

🧵 Async Example Output
----------------------

[](#-async-example-output)

```
{
  "transport": "queue",
  "status": "queued",
  "queue_size": 1
}
```

---

🔌 Plugin System
---------------

[](#-plugin-system)

```
interface OfficialPluginInterface
{
    public function name(): string;
    public function version(): string;
    public function register(PluginContext $context): void;
}
```

### Official Plugins

[](#official-plugins)

- CSRF Protection
- Captcha Integration
- Media Upload
- Audit Trail
- Async Dispatch Enhancements

---

🧠 Architecture
--------------

[](#-architecture)

```
src/
├── Application/
│   ├── Runtime/
│   ├── Headless/
│   ├── Frontend/
│   ├── Profiling/
│   ├── Diagnostics/
│   ├── Ecosystem/
│   └── Sdk/
├── Domain/
├── Infrastructure/
└── Integration/

```

---

🛠 CLI
-----

[](#-cli)

```
php bin/console debug:schema
php bin/console debug:profile
php bin/console debug:diagnostics
php bin/console plugin:list
php bin/console ecosystem:report
```

---

📊 Quality
---------

[](#-quality)

### Tests

[](#tests)

```
vendor/bin/phpunit
```

### Static Analysis

[](#static-analysis)

```
vendor/bin/phpstan analyse src tests
```

---

📚 Documentation
---------------

[](#-documentation)

- Async Runtime
- Queue Transport
- Distributed Execution
- Plugin Development
- Advanced SDKs

---

🔄 Versioning
------------

[](#-versioning)

Fluxon follows **Semantic Versioning**:

- **Major** → architecture changes
- **Minor** → new features
- **Patch** → fixes and stability

---

🤝 Contributing
--------------

[](#-contributing)

1. Fork the repository
2. Create a feature branch
3. Add tests
4. Submit a Pull Request

---

📜 License
---------

[](#-license)

MIT

---

🌍 Vision
--------

[](#-vision)

Fluxon is a **schema-driven platform** for building:

- dynamic UIs
- API-driven applications
- distributed systems

---

🧩 Roadmap
---------

[](#-roadmap)

- JavaScript SDK (React/Vue)
- Plugin marketplace
- Redis / SQS transport
- Visual form builder
- Distributed runtime engine

---

⭐ Why Fluxon?
-------------

[](#-why-fluxon)

- Clean architecture
- Headless-first design
- Async-ready
- Plugin ecosystem
- Production-grade tooling

---

[![Build Status](https://camo.githubusercontent.com/0f6553ccbbfd99c3dd5d140c28eb07a0c3e85ab6f948b5fc091b27b26f126806/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f69726976656e67726f75702f666c75786f6e2f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/irivengroup/fluxon/build-status/master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/6e33d7ef5d8e68f86a2f09d8ba7f36faa720d381d569fddbb0679060ec5677e3/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f69726976656e67726f75702f666c75786f6e2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/irivengroup/fluxon/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/d300e9619f9abbfe3624b6b0b9e599858268916bd5bcde561d08acfd9974d898/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f69726976656e67726f75702f666c75786f6e2f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/irivengroup/fluxon/?branch=master)[![Code Intelligence Status](https://camo.githubusercontent.com/343c8d787332571bd57a64c26bff064a826631795284cded9f1e5bf7b555e6fe/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f69726976656e67726f75702f666c75786f6e2f6261646765732f636f64652d696e74656c6c6967656e63652e7376673f623d6d6173746572)](https://scrutinizer-ci.com/code-intelligence)[![Latest Version](https://camo.githubusercontent.com/0721b0413f4815a2f7eb27f6b314b4dbd8e96d0679de03805faf9fbc1e52259e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f69726976656e2f666c75786f6e)](https://packagist.org/packages/iriven/fluxon)[![Downloads](https://camo.githubusercontent.com/3f0f5ba800146142d2c63642e4e65f1b744fe4fef7c85b7e136441110b8d890b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f69726976656e2f666c75786f6e)](https://packagist.org/packages/iriven/fluxon)[![PHP Version](https://camo.githubusercontent.com/187240af044d09d5b14a1d9d9ebdf3f7a993e4c7bc09bdb46b4ba661a891bf5b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c7565)](#)[![Status](https://camo.githubusercontent.com/f3adeea933a64c2014c89092040b8c02f4931f3f5a5d46a189133d4ac21d0ebf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7374617475732d737461626c652d627269676874677265656e)](#)[![License](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)](#)

💡 Signature
-----------

[](#-signature)

> Fluxon — PHP Form Engine. Limitless Possibilities.

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance90

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 81.6% of commits — single point of failure

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

Total

28

Last Release

48d ago

Major Versions

v3.9.5-stable → v4.1.2-alpha2026-04-16

v4.9.1-stable → v5.0.0-alpha2026-04-17

v5.9.1-beta → v6.0.0-stable2026-04-21

### Community

Maintainers

![](https://www.gravatar.com/avatar/ea598603eaacd37a50ad0065152a652d14dfb1e7f98ef192f045d1720a0691ef?d=identicon)[irivengroup](/maintainers/irivengroup)

---

Top Contributors

[![irivengroup](https://avatars.githubusercontent.com/u/275132393?v=4)](https://github.com/irivengroup "irivengroup (217 commits)")[![iriven](https://avatars.githubusercontent.com/u/6275596?v=4)](https://github.com/iriven "iriven (49 commits)")

---

Tags

phpapischemavalidationruntimeheadlessfrontendForms

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[orisai/object-mapper

Raw data mapping to validated objects

1133.6k2](/packages/orisai-object-mapper)

PHPackages © 2026

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