PHPackages                             velkymx/vibefw - 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. [Framework](/categories/framework)
4. /
5. velkymx/vibefw

ActiveProject[Framework](/categories/framework)

velkymx/vibefw
==============

VibeFW: A high-performance, security-focused PHP 8.4+ MVC framework

v2.1.19(2mo ago)113MITPHPPHP >=8.4CI failing

Since Feb 4Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/velkymx/vibefw)[ Packagist](https://packagist.org/packages/velkymx/vibefw)[ Docs](https://github.com/velkymx/vibefw)[ RSS](/packages/velkymx-vibefw/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (7)Dependencies (12)Versions (11)Used By (0)

VibeFW v2.1
===========

[](#vibefw-v21)

[![PHP Version](https://camo.githubusercontent.com/6e44ad49e5307c87d1393389feb52ab61c99956e2e5f8c77177b2501f1d3d47f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e342d3838393242462e737667)](https://www.php.net/)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE)![Tests](https://camo.githubusercontent.com/3ab4882a1b7d64e5eb5168ad0b0b9cdfd53f59f114ee5f727958504214a5789c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f74657374732d70617373696e672d627269676874677265656e2e737667)

A high-performance, security-focused PHP 8.4+ MVC framework built for modern, high-concurrency web development.

v2.1: SPA Scaffold + Security Hardening
---------------------------------------

[](#v21-spa-scaffold--security-hardening)

VibeFW v2.1 adds first-class SPA tooling, security improvements, and correctness fixes across the framework.

### What's New in 2.1

[](#whats-new-in-21)

- **`make:spa` command** — Scaffold a production-ready Vue 3 + TypeScript + Vite SPA in seconds. Generates a full-stack starter (PHP API + Vue frontend) with auth, routing, and VibeUI components wired up. Runs `npm install` and `npm run build` automatically.
- **HTTPS-aware auth cookies** — Remember-me cookies now set `Secure: true` automatically in production.
- **QueryBuilder SELECT quoting** — Column identifiers in SELECT clauses are now properly quoted.
- **Worker-mode safe `Str` caches** — Static conversion caches are now bounded at 512 entries.

See [CHANGELOG.md](CHANGELOG.md) for the full list of changes.

v2.0: The Concurrency Update
----------------------------

[](#v20-the-concurrency-update)

VibeFW v2.0 is a ground-up architectural refactor designed for persistent runtimes like **FrankenPHP Worker Mode**. It introduces true request isolation and massive performance gains.

### Key v2.0 Features

[](#key-v20-features)

- **40,000+ Requests/Sec** - Optimized for high-concurrency worker environments.
- **Fiber-Isolated State** - Automatic request isolation using Fiber-local container singletons and `WeakMap` context.
- **Zero-Side-Effect Response** - `Response` is now a pure value object, decoupled from PHP's output buffer.
- **Strictly Immutable QueryBuilder** - Prevents silent query contamination across branching logic.
- **Bulletproof Memory Management** - Automatic state resetting and container flushing prevents leaks in long-running processes.

Features
--------

[](#features)

- **Blazing Fast** - 40,000+ requests/sec with FrankenPHP worker mode.
- **Security First** - Built-in protection against CSRF, XSS, SQL injection, and timing attacks.
- **True Async I/O** - Non-blocking HTTP and Database execution using PHP Fibers and EventLoop.
- **Result/Option Types** - Null-safe, exception-free error handling.
- **Active Record ORM** - Elegant, immutable database interactions with mass assignment protection.
- **CQRS & Events** - Command/Query separation and event-driven architecture built-in.
- **Modern PHP** - Leveraging property hooks, asymmetric visibility, and readonly properties.

Requirements
------------

[](#requirements)

- PHP 8.4+
- Composer
- SQLite, MySQL, or PostgreSQL

Quick Start
-----------

[](#quick-start)

### Create a New Project

[](#create-a-new-project)

```
composer create-project velkymx/vibefw my-app
cd my-app
```

That's it. Composer automatically:

- Creates `.env` with secure keys
- Sets up storage directories
- Creates the SQLite database
- Runs all migrations

### Add a Vue 3 Frontend (Optional)

[](#add-a-vue-3-frontend-optional)

```
php fw make:spa
```

Generates a complete SPA with auth, routing, and VibeUI components. See the [SPA Quick Start](docs/spa-quick-start.md) for details.

### Manual Setup (for cloned repos)

[](#manual-setup-for-cloned-repos)

```
git clone https://github.com/velkymx/vibefw.git my-app
cd my-app
composer install
php fw setup
```

### Run in High-Performance Worker Mode (Recommended)

[](#run-in-high-performance-worker-mode-recommended)

VibeFW is designed to run at peak performance using FrankenPHP:

```
./frankenphp php-server --listen :8080 --worker public/index.php
```

CLI Commands
------------

[](#cli-commands)

```
php fw                              # List all commands

# Project Setup
php fw setup                        # Initialize project (env, keys, database)
php fw make:spa                     # Scaffold Vue 3 + TypeScript SPA

# Code Generation
php fw make:model Post -m           # Model + migration
php fw make:controller PostController -r  # Resource controller
php fw make:migration create_posts_table

# Database
php fw migrate                      # Run pending migrations
php fw migrate:fresh                # Drop all & re-migrate

# Development
php fw serve --port=8080            # Start standard dev server
php fw routes:list                  # List all routes
php fw security:check               # Security scan
```

### Full-Stack in Two Commands

[](#full-stack-in-two-commands)

```
composer create-project velkymx/vibefw my-app
cd my-app && php fw make:spa
```

The SPA scaffold generates a complete Vue 3 + TypeScript + VibeUI frontend with:

- **Home** — Public landing page with feature cards
- **Login / Register** — Auth forms with validation, wired to the PHP API
- **Dashboard** — Protected stats page inside a sidebar + topbar shell
- **Dark mode** — Toggle with Bootstrap CSS variable support
- **TypeScript types** — Interfaces for all API responses

Documentation
-------------

[](#documentation)

- [**SPA Quick Start**](docs/spa-quick-start.md) — Build a full-stack app in 5 minutes
- [**Changelog**](CHANGELOG.md)
- [**Upgrading to v2.0.0**](docs/UPGRADING-1.0.5-to-2.0.0.md)
- [Controllers](docs/controllers.md)
- [Models](docs/models.md)
- [Views](docs/views.md)
- [Routing](docs/routing.md)
- [Middleware](docs/middleware.md)
- [Result & Option Types](docs/result-option.md)
- [Database & Migrations](docs/database.md)
- [VibeUI Components](https://github.com/velkymx/vibeui/blob/main/docs/README.md) — Full component reference
- [VibeUI AI Blueprint](docs/VIBE-UI-AI.md) — AI agent integration guide

Performance
-----------

[](#performance)

Benchmarked with FrankenPHP worker mode on Apple M2 (MacBook Air):

MetricResult**Requests per Second****40,058.37****Average Latency****5.15ms****Total Requests (30s)****1,202,023****Memory Stability****Perfect** (Zero leaks after 1.2M requests)Core Concepts
-------------

[](#core-concepts)

### Immutable Query Building

[](#immutable-query-building)

The QueryBuilder is now immutable. Chaining works normally, but conditional steps require re-assignment:

```
$query = User::where('active', true);

if ($adminOnly) {
    $query = $query->where('role', 'admin'); // Capture the new instance
}

$users = $query->orderBy('name')->get();
```

### Side-Effect Free Responses

[](#side-effect-free-responses)

Controllers return `Response` objects which are emitted by the kernel. No more global `header()` calls or `exit()`.

```
public function index(Request $request): Response
{
    return $this->view('welcome')
        ->header('X-Framework', 'VibeFW')
        ->cache(3600);
}
```

Testing
-------

[](#testing)

```
composer test      # Runs all 920+ tests
composer ci        # Full pipeline (Lint, Static Analysis, Tests)
```

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance94

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~4 days

Total

8

Last Release

60d ago

Major Versions

v1.0.5 → v2.0.02026-03-06

### Community

Maintainers

![](https://www.gravatar.com/avatar/593434237f4ae6bb98da226c3ab6701a5126771091391c991738b9e6085c8230?d=identicon)[velkymx](/maintainers/velkymx)

---

Top Contributors

[![velkymx](https://avatars.githubusercontent.com/u/535300?v=4)](https://github.com/velkymx "velkymx (112 commits)")

---

Tags

frameworkphp-frameworkphp8vibe-codingasyncframeworksecurityperformancemvcphp8fiber

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[easyswoole/orm

php stander lib

3088.7k17](/packages/easyswoole-orm)[mirekmarek/php-jet

PHP Jet is modern, powerful, real-life proven, really fast and secure, small and light-weight framework for PHP8 with great clean and flexible modular architecture containing awesome developing tools. No magic, just clean software engineering.

241.3k](/packages/mirekmarek-php-jet)

PHPackages © 2026

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