Download the PHP package monkeyscloud/monkeyslegion without Composer
On this page you can find all versions of the php package monkeyscloud/monkeyslegion. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download monkeyscloud/monkeyslegion
More information about monkeyscloud/monkeyslegion
Files in monkeyscloud/monkeyslegion
Package monkeyslegion
Short Description High-performance PHP 8.4 framework โ attribute-first architecture, property hooks, compiled DI, MLC configuration.
License MIT
Informations about the package monkeyslegion
MonkeysLegion Framework
MonkeysLegion is a high-performance, attribute-first PHP 8.4+ framework built for modern web applications and APIs. It leverages PHP 8.4 property hooks, strict types, and compiled DI to deliver a developer experience that rivals Laravel and Symfony โ with zero runtime compromise.
๐ What's New in v2.0
- PHP 8.4 Property Hooks โ Native getters/setters via property hooks across all packages
- Attribute-First Architecture โ Routes, validation, providers, and commands discovered via attributes
- MLC Configuration โ
.mlcfile format with env interpolation, cascading, and production compilation - Compiled DI Container โ Zero-overhead production builds with atomic cache writes
- 26 Integrated Packages โ Every component pinned to v2.0+ for API consistency
- PSR-15 Middleware Pipeline โ Native security headers, CORS, rate limiting, CSRF, and request ID
- Apex AI/ML โ Built-in AI provider abstraction with OpenAI, cost tracking, and embeddings
- 182-Test Suite โ Comprehensive PHPUnit 11 test coverage across all framework layers
โจ Features
| Category | Details |
|---|---|
| ๐ฏ PSR Compliant | PSR-7, PSR-11, PSR-14, PSR-15, PSR-16, PSR-17 |
| ๐ง Modular | 26 independent, composable packages |
| ๐ Auth | JWT, OAuth2, 2FA, API Keys, RBAC, Policies, remember-me |
| ๐๏ธ Database | Connection manager, QueryBuilder, migrations, entity scanner |
| ๐จ Templates | Custom engine with caching, layouts, and directives |
| ๐ Routing | Attribute-based, auto-discovered, grouped, middleware-aware |
| โก DI | PSR-11 container with compiled cache for production |
| ๐ Validation | Attribute-based validation with DTO binding |
| ๐ I18n | Multi-language with database and file loaders |
| ๐ง Mail | SMTP and API-based email delivery |
| ๐ Telemetry | OpenTelemetry-compatible metrics, tracing, and structured logging |
| ๐ช Events | PSR-14 event dispatcher with listener auto-discovery |
| ๐พ Cache | Redis, file, in-memory backends (PSR-16) |
| ๐จ Queue | Background job processing with workers and retry |
| ๐ Files | Unified storage, image processing, garbage collection |
| ๐ OpenAPI | Auto-generated API docs from route attributes |
| ๐ค AI/ML | Apex: OpenAI provider, cost tracking, embeddings |
| ๐ CLI | Attribute-discovered commands, schedule, dev-server |
| ๐ก๏ธ Security | OWASP headers, CORS, rate limiting, CSRF, maintenance mode |
๐ฆ Included Packages
| Package | Version | Description |
|---|---|---|
monkeyslegion-core |
^2.0 | Core utilities, helpers, and base contracts |
monkeyslegion-di |
^2.0 | PSR-11 dependency injection container |
monkeyslegion-http |
^2.0 | PSR-7/PSR-15/PSR-17 HTTP layer and security middleware |
monkeyslegion-router |
^2.1 | Attribute-based routing with auto-discovery |
monkeyslegion-database |
^2.0 | Connection manager, PDO abstraction, transactions |
monkeyslegion-query |
^2.0 | Fluent QueryBuilder with grammar compilation |
monkeyslegion-entity |
^2.0 | Entity scanner and metadata extraction |
monkeyslegion-migration |
^2.0 | Database migration generator and runner |
monkeyslegion-auth |
^2.1 | JWT, session guards, password hashing, RBAC |
monkeyslegion-validation |
^2.0 | Attribute-based validation and DTO binding |
monkeyslegion-cache |
^2.0 | PSR-16 cache: Redis, file, in-memory stores |
monkeyslegion-session |
^2.0 | Session manager with CSRF middleware |
monkeyslegion-template |
^2.0 | Template engine with caching and layouts |
monkeyslegion-events |
^2.0 | PSR-14 event dispatcher |
monkeyslegion-logger |
^2.0 | PSR-3 logger with rotating file handlers |
monkeyslegion-queue |
^1.2 | Queue factory, workers, and job dispatching |
monkeyslegion-schedule |
^1.1 | Task scheduling with cron expressions |
monkeyslegion-mail |
^1.1 | SMTP and API-based email |
monkeyslegion-i18n |
^2.1 | Internationalization and locale management |
monkeyslegion-telemetry |
^2.0 | Metrics, distributed tracing, request middleware |
monkeyslegion-files |
^2.0 | File storage, image processing, garbage collection |
monkeyslegion-mlc |
^3.2 | MLC config parser with env interpolation |
monkeyslegion-cli |
^2.0 | CLI kernel with attribute-discovered commands |
monkeyslegion-apex |
^1.0 | AI/ML abstraction: OpenAI, cost tracking |
monkeyslegion-openapi |
^1.0 | Auto-generated OpenAPI v3 documentation |
monkeyslegion-dev-server |
^1.0 | Built-in development server |
๐จ Installation
Requirements
- PHP 8.4+ (uses property hooks and modern features)
- Composer 2.x
- MySQL/MariaDB/PostgreSQL/SQLite (any PDO-supported database)
- Redis (optional โ for caching, queues, sessions, and rate limiting)
Quick Start
Project Structure
๐๏ธ Architecture
Boot Sequence
Request Lifecycle (HTTP)
๐ Usage Guide
Entry Point (v2.0)
public/index.php
Migration from v1: Replace
HttpBootstrap::run()withApplication::create()->run(). The legacy class still works but triggers a deprecation notice.
Configuration (MLC Format)
MonkeysLegion uses .mlc files โ a clean, typed config format with env interpolation:
config/app.mlc
config/database.mlc
config/auth.mlc
Environment cascade: .env โ .env.local โ .env.{APP_ENV} โ .env.{APP_ENV}.local
Routing
Define routes using PHP 8 attributes with auto-discovery:
Database & Query Builder
Authentication
Auth capabilities: JWT, OAuth2 (Google, GitHub), TOTP 2FA, password reset, API keys, RBAC, policies, rate limiting, token blacklisting, remember-me.
Validation & DTO Binding
Service Providers
Create custom modular providers with attribute discovery:
Template Engine
Events (PSR-14)
AI/ML with Apex
Queue System
File Management
Internationalization
Telemetry & Observability
Maintenance Mode
CLI Commands
Custom Middleware
Register in config/middleware.mlc:
๐งช Testing
MonkeysLegion ships with a comprehensive test suite (PHPUnit 11):
Test Suite Coverage
| Test Class | Target | Tests |
|---|---|---|
CompiledContainerCacheTest |
DI compiled cache | 14 |
AttributeTest |
Provider & BootAfter attributes | 7 |
MaintenanceModeMiddlewareTest |
Maintenance mode bypass | 7 |
ProviderScannerTest |
Auto-discovery scanner | 4 |
AppConfigTest |
Provider aggregator & context | 7 |
ConfigLoaderTest |
MLC config loading | 4 |
ProviderDefinitionsTest |
All 19 service providers | 90+ |
ApplicationTest |
Boot lifecycle & container | 13 |
ExceptionHandlerTest |
Error handling (JSON/HTML) | 10 |
DatabaseUserProviderTest |
Auth user operations | 15 |
HttpBootstrapTest |
v1 deprecation | 1 |
| Total | 182 tests, 440 assertions |
Writing Tests
โก Production Optimization
Compiled Container
MLC Config Compilation
The ConfigLoader automatically compiles .mlc files to PHP arrays in var/cache/config.compiled.php for production. No parsing overhead on subsequent requests.
OPcache
๐ง Environment Configuration
| Variable | Default | Description |
|---|---|---|
APP_ENV |
production |
Environment: production, staging, dev, testing |
APP_DEBUG |
false |
Enable debug mode (error details, stack traces) |
APP_URL |
โ | Application base URL |
APP_TIMEZONE |
UTC |
Default timezone |
DB_CONNECTION |
mysql |
Database driver |
DB_HOST |
127.0.0.1 |
Database host |
DB_PORT |
3306 |
Database port |
DB_DATABASE |
โ | Database name |
DB_USERNAME |
root |
Database user |
DB_PASSWORD |
โ | Database password |
JWT_SECRET |
โ | JWT signing key |
REDIS_HOST |
127.0.0.1 |
Redis host |
REDIS_PORT |
6379 |
Redis port |
๐ API Reference
For detailed API documentation, visit monkeyslegion.com/docs or explore the individual package repositories on GitHub.
๐ค Contributing
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/my-feature) - Commit your changes (
git commit -m 'feat: add my feature') - Push to the branch (
git push origin feature/my-feature) - Open a Pull Request
๐ License
MonkeysLegion is open-source software licensed under the MIT License.
๐ Credits
Created and maintained by the MonkeysCloud team.
๐ Support
- Documentation: monkeyslegion.com/docs
- Issues: github.com/MonkeysCloud/MonkeysLegion/issues
- Discussions: github.com/MonkeysCloud/MonkeysLegion/discussions
๐บ๏ธ Roadmap
โ Completed in v2.0
- [x] PHP 8.4 property hooks & attribute-first architecture
- [x] 26-package modular ecosystem pinned to v2.0+
- [x] MLC configuration with env cascading & production compilation
- [x] Compiled DI container with atomic cache writes
- [x] PSR-15 middleware pipeline with OWASP security headers
- [x] Comprehensive auth: JWT, OAuth2, 2FA, RBAC, remember-me
- [x] Apex AI/ML abstraction with OpenAI, cost tracking & embeddings
- [x] OpenAPI v3 auto-generation from route attributes
- [x] CLI scaffolding:
make:controller,make:entity,make:migration,make:middleware,make:dto,make:event,make:listener,make:policy,make:job,make:service,make:test,make:factory,make:seeder,make:enum,make:observer,make:resource,make:command - [x] Database seeder and factory system (
seed:run,make:seeder,make:factory) - [x] Telemetry: OpenTelemetry-compatible metrics, distributed tracing
- [x] Event broadcasting interface (
ShouldBroadcast) - [x] Maintenance mode with IP/secret bypass (
ml down/ml up) - [x] Tinker REPL (
ml tinker) - [x] 182-test suite with PHPUnit 11
๐ v2.1
- [ ] Notifications package (email, SMS, Slack, push)
- [ ] WebSocket server with real-time broadcasting driver
- [ ] Database model factories for testing (
Factory::define()) - [ ] Rate limiting per-route via attributes
- [ ] API resource transformers & pagination
๐ฎ v3.0
- [ ] GraphQL support with attribute-based schema
- [ ] Admin panel generator (CRUD scaffolding)
- [ ] Fibers-based async HTTP client
- [ ] Native Swoole/FrankenPHP runtime support
- [ ] Plugin marketplace
Built with โค๏ธ by MonkeysCloud
All versions of monkeyslegion with dependencies
monkeyscloud/monkeyslegion-apex Version ^1.1
monkeyscloud/monkeyslegion-auth Version ^2.1
monkeyscloud/monkeyslegion-cache Version ^2.0
monkeyscloud/monkeyslegion-cli Version ^2.0
monkeyscloud/monkeyslegion-contracts Version ^2.0
monkeyscloud/monkeyslegion-core Version ^2.0
monkeyscloud/monkeyslegion-database Version ^2.1
monkeyscloud/monkeyslegion-dev-server Version ^1.0
monkeyscloud/monkeyslegion-devtools Version ^2.0
monkeyscloud/monkeyslegion-di Version ^2.0
monkeyscloud/monkeyslegion-entity Version ^2.0
monkeyscloud/monkeyslegion-events Version ^2.0
monkeyscloud/monkeyslegion-files Version ^2.0
monkeyscloud/monkeyslegion-http Version ^2.0
monkeyscloud/monkeyslegion-i18n Version ^2.1
monkeyscloud/monkeyslegion-logger Version ^2.0
monkeyscloud/monkeyslegion-mail Version ^2.0
monkeyscloud/monkeyslegion-migration Version ^2.0
monkeyscloud/monkeyslegion-mlc Version ^3.2
monkeyscloud/monkeyslegion-openapi Version ^1.0
monkeyscloud/monkeyslegion-query Version ^2.0
monkeyscloud/monkeyslegion-queue Version ^2.0
monkeyscloud/monkeyslegion-router Version ^2.1
monkeyscloud/monkeyslegion-schedule Version ^1.1
monkeyscloud/monkeyslegion-session Version ^2.0
monkeyscloud/monkeyslegion-sockets Version ^1.1
monkeyscloud/monkeyslegion-telemetry Version ^2.0
monkeyscloud/monkeyslegion-template Version ^2.0
monkeyscloud/monkeyslegion-validation Version ^2.0