PHPackages                             witals/framework - 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. witals/framework

ActiveLibrary[Framework](/categories/framework)

witals/framework
================

025PHP

Since Mar 26Pushed 1mo agoCompare

[ Source](https://github.com/puleeno/witals-framework)[ Packagist](https://packagist.org/packages/witals/framework)[ RSS](/packages/witals-framework/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

🚀 Witals Framework
==================

[](#-witals-framework)

A modern, high-performance PHP framework designed for **dual runtime support**. Witals seamlessly adapts between **Traditional Web Servers** (PHP-FPM, Apache, Nginx) and **Long-Running Runtimes** (RoadRunner, ReactPHP, Swoole, OpenSwoole).

---

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

[](#-key-features)

- 🎭 **Unified Entry Point**: One command to rule them all with `php witals serve`.
- 🔄 **Ambient Runtime Detection**: Automatically detects and adapts to its environment.
- 🏗️ **Architected for Scale**: Built-in IoC container with advanced request-isolation scopes.
- 🔒 **Stateless & Stateful Support**: Fine-grained state management tailored for each runtime.
- ⚡ **Turbocharged Performance**: Optimized for async, coroutines, and event loops.
- 📝 **Enterprise Logging**: High-performance PSR-3 logging with memory buffering and JSON support.
- 🛠️ **Developer Experience**: Modern PHP 8.1+ features with strict typing.

📦 Requirements
--------------

[](#-requirements)

- **PHP 8.1+**
- **Composer**
- (Optional) Extensions for high-performance runtimes: `ext-swoole`, `ext-openswoole`, or `ext-roadrunner`.

🚀 Quick Start
-------------

[](#-quick-start)

### 1. Installation

[](#1-installation)

```
composer require witals/framework
```

### 2. Traditional Serving (FPM/CGI)

[](#2-traditional-serving-fpmcgi)

Point your web server (Nginx/Apache) to `public/index.php`. Witals automatically detects the traditional runtime and handles request/response in a stateless manner.

### 3. High-Performance Serving

[](#3-high-performance-serving)

Witals comes with a unified binary to launch high-performance servers:

```
# Start with auto-detected runtime (RoadRunner > Swoole > OpenSwoole > ReactPHP)
php witals serve

# Force a specific runtime
php witals serve --swoole
php witals serve --reactphp --port=9000
```

🛠️ Core Concepts
----------------

[](#️-core-concepts)

### Request Lifecycle Management

[](#request-lifecycle-management)

Witals manages the request lifecycle through specific phases: **Init → Execute → Respond → Shutdown**.

- **Stateless**: The entire app boots and shuts down for every request.
- **Stateful**: The app boots once, handles multiple requests in an isolation scope, and cleans up after each request to prevent memory leaks.

### Dependency Injection & Scoping

[](#dependency-injection--scoping)

The framework ensures that services resolved during a request are automatically cleaned up when the request ends.

```
// Services resolved within handle() are request-scoped
$response = $app->handle($request);
```

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

[](#-documentation)

- [**QUICKSTART.md**](./QUICKSTART.md) - Get up and running in minutes.
- [**ARCHITECTURE.md**](./ARCHITECTURE.md) - Deep dive into the framework internals.
- [**RUNTIME.md**](./RUNTIME.md) - Detailed guide on supported runtimes.
- [**LIFECYCLE.md**](./LIFECYCLE.md) - Understanding the execution flow.

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

[](#-contributing)

We welcome contributions! Please follow the PSR-12 coding standard and ensure all tests pass before submitting a PR.

📄 License
---------

[](#-license)

The Witals Framework is open-sourced software licensed under the [MIT license](LICENSE).

---

Created with ❤️ by **Puleeno Nguyen** ()

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance59

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/6a609a3b3a36dee9f36ef6f8d3b2b2dc91eebefc7644031e829e65bca4329799?d=identicon)[puleeno](/maintainers/puleeno)

---

Top Contributors

[![puleeno](https://avatars.githubusercontent.com/u/22538657?v=4)](https://github.com/puleeno "puleeno (32 commits)")

### Embed Badge

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

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

###  Alternatives

[laravel/passport

Laravel Passport provides OAuth2 server support to Laravel.

3.4k85.0M532](/packages/laravel-passport)[nolimits4web/swiper

Most modern mobile touch slider and framework with hardware accelerated transitions

41.8k177.2k1](/packages/nolimits4web-swiper)[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k36.7M259](/packages/laravel-dusk)[laravel/prompts

Add beautiful and user-friendly forms to your command-line applications.

712181.8M596](/packages/laravel-prompts)[cakephp/chronos

A simple API extension for DateTime.

1.4k47.7M121](/packages/cakephp-chronos)[laravel/pail

Easily delve into your Laravel application's log files directly from the command line.

91545.3M590](/packages/laravel-pail)

PHPackages © 2026

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