embegeq/framework

The EmbegeQ Framework - A memory-safe, PSR Bridge Architecture for stateful PHP workers.

dev-main / 0.1.x-dev 2026-06-24 05:57 UTC

Requires

• php: >=8.4
• ext-ctype: *
• ext-mbstring: *
• ext-openssl: *
• ext-tokenizer: *
• league/flysystem: ^3.25
• monolog/monolog: ^3.0
• nyholm/psr7: ^1.8
• nyholm/psr7-server: ^1.1
• psr/container: ^2.0
• psr/event-dispatcher: ^1.0
• psr/http-factory: ^1.1
• psr/http-message: ^2.0
• psr/http-server-handler: ^1.0
• psr/http-server-middleware: ^1.0
• psr/log: ^3.0
• psr/simple-cache: ^3.0

Requires (Dev)

• nikic/fast-route: ^2.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.5 || ^12.0
• symfony/console: ^7.4 || ^8.0
• symfony/mailer: ^7.4 || ^8.0

Suggests

• ext-pdo: Required to use all database features.
• ext-redis: Required to use the Redis cache and session drivers.
• league/flysystem: Required for the filesystem abstraction layer (^3.25).
• monolog/monolog: Required for the default logging implementation (^3.0).
• nikic/fast-route: Required for the default routing implementation (^2.0).
• symfony/console: Required for the CLI application layer (^7.4 || ^8.0).
• symfony/mailer: Required for the mail transport layer (^7.4 || ^8.0).

Provides

• psr/container-implementation: 2.0
• psr/event-dispatcher-implementation: 1.0
• psr/log-implementation: 3.0
• psr/simple-cache-implementation: 3.0

MIT

• EmbegeQ

• framework
• stateful
• psr
• swoole
• roadrunner
• frankenphp
• embegeq
• memory-safe

README

About EmbegeQ Framework

EmbegeQ Framework is the core kernel of the EmbegeQ PHP ecosystem. It provides a memory-safe, PSR-compliant foundation specifically engineered for stateful PHP runtimes such as FrankenPHP, RoadRunner, and Swoole.

Unlike traditional PHP frameworks built around the shared-nothing PHP-FPM model, EmbegeQ solves critical architectural flaws that emerge when running PHP in a persistent event loop:

• Memory Leak Prevention through a strict Dual-Scope Dependency Injection container.
• State Bleeding Protection by isolating ApplicationScope (boot-once singletons) from RequestScope (per-request instances).
• PSR Bridge Architecture that wraps battle-tested libraries (nyholm/psr7, nikic/fast-route, monolog/monolog) behind unified, cohesive Contracts.

The Nutrisi Component Layer

EmbegeQ's internal components live under the EmbegeQ\Nutrisi\ namespace (analogous to Laravel's Illuminate\). The name Nutrisi reflects the framework's "Nutritional Architecture" philosophy: each component is a distinct nutrient that the application absorbs to function at peak performance.

src/Nutrisi/
├── Auth/           Guards, User Providers
├── Broadcasting/   Broadcaster Interfaces
├── Bus/            Command Bus, Dispatcher
├── Cache/          CacheManager (PSR-16)
├── Collections/    LazyCollections, Arrays
├── Config/         Repository, FileLoader
├── Console/        CLI Application
├── Container/      Dual-Scope PSR-11 DI
├── Contracts/      Unified Framework Interfaces
├── Cookie/         CookieJar, Encryption Middleware
├── Database/       ConnectionManager, Query Builder
├── Encryption/     OpenSSL/Sodium Encrypter
├── Events/         PSR-14 Event Dispatcher
├── Filesystem/     FilesystemManager (Flysystem)
├── Foundation/     Application Kernel, Bootstrappers
├── Hashing/        Bcrypt, Argon Hashers
├── Http/           PSR-15 Middleware Pipeline
├── Log/            LogManager (Monolog)
├── Mail/           Mailer (Symfony Mailer)
├── Pagination/     Paginator, CursorPaginator
├── Pipeline/       Generic Task Pipeline
├── Queue/          QueueManager, Worker
├── Redis/          RedisManager
├── Routing/        Router (FastRoute)
├── Session/        Stateful-Safe SessionManager
├── Support/        Helpers, ServiceProviders
├── Translation/    Translator, FileLoader
├── Validation/     ValidatorFactory, Rules
└── View/           ViewFactory, Compilers

Requirements

• PHP >= 8.4
• ext-ctype
• ext-mbstring
• ext-openssl

Installation

composer require embegeq/framework

Security Vulnerabilities

If you discover a security vulnerability within EmbegeQ Framework, please send an email to the security team at [e-mail]. All security vulnerabilities will be promptly addressed.

License

The EmbegeQ Framework is open-sourced software licensed under the MIT license.