-
Notifications
You must be signed in to change notification settings - Fork 0
Home
A modular PHP framework built for manageable development environments. Multi-site, distributor-based architecture with high performance and flexibility.
PHP 8.2+ PSR-4 / PSR-11 / PSR-12 / PSR-16 4,564 Tests 8,178 Assertions MIT License
🚀 Tutorial — Build Your First App → 🗺️ Learning Roadmap — 30 min → 1 day → 1 week → Get Started → GitHub
📦
Reusable modules with controllers, views, plugins, and APIs. Vendor/package namespace structure with semantic versioning.
🌐
Run multiple sites from one codebase. Distributors manage domains, modules, and configurations independently.
🔌
Extend Template, Collection, Statement, and Pipeline with custom plugins. Shared plugin trait across subsystems.
🗄️
Multi-driver support (MySQL, PostgreSQL, SQLite) with fluent Statement builder, Strategy-pattern SQL syntax builders, and Simple Syntax for shorthand SQL.
🎨
High-performance templating with variable tags, modifiers, function tags, and advanced block types (WRAPPER, RECURSION).
📡
Inter-module communication via EventEmitter pattern. Fire events, listen across modules, collect responses.
🔗
Provider/Consumer pattern for module-to-module integration. Handshake-based access control.
⚡
Full CLI tooling via Razy.phar. Interactive shell, module validation, GitHub installer, and more.
🧪
PHPUnit 10.5 with 4,564 tests and 8,178 assertions across 102 test classes. PSR-12 linting with PHP CS Fixer.
🏗️
PSR-11 compliant DI Container with auto-wiring, singleton/transient bindings, and alias support. Semantic exception hierarchy with 17 typed exceptions.
# Install via Composer
composer require rayfunghk/razy
# Build Razy environment
php Razy.phar build
# Initialize a new distributor
php Razy.phar init dist mysite
# Generate .htaccess rewrite rules
php Razy.phar rewrite mysite
# Run interactive shell
php Razy.phar runapp mysiteBootstrap→Application→Domain→Distributor→Modules→Routing
The framework follows a pipeline from bootstrap to route execution. Each distributor manages its own set of modules, which are loaded in dependency order and go through a well-defined lifecycle.
Learn more about the architecture →
| Feature | Status |
|---|---|
| GitHub Module Installer | ✅ Done |
| Simplified Application Flow | ✅ Done |
| App Container CLI (runapp) | ✅ Done |
| Revamped Action & Validate | ✅ Done |
| Cache System (PSR-16) | ✅ Done |
| Thread System | ✅ Done |
| Table/Column Class Revamp | ✅ Done |
| DI Container (PSR-11) | ✅ Done |
| Semantic Exception Hierarchy | ✅ Done |
| Statement Builder Refactor | ✅ Done |
| Cross-Distributor Communication | Planned |