Warning
This branch contains the ongoing, unreleased work for the Hypervel 0.4 rewrite.
Hypervel 0.4 is not ready for use yet. APIs, behavior, configuration, and package internals may change unexpectedly while the rewrite is still in progress.
If you are experimenting with this branch, use the in-progress 0.4 documentation. If you are coming from Laravel, begin with the porting guide.
Please do not use this branch for projects until a beta release is tagged. If you are experimenting or testing the rewrite, bug reports and feedback are very welcome.
Note
This repository contains the core components of the Hypervel framework. If you want to create a Hypervel application, visit the Hypervel application repository.
Hypervel is a modern, asynchronous PHP framework built for high performance and scalability.
Hypervel runs applications in long-lived Swoole workers, using coroutines to handle requests, background jobs, and network operations concurrently. While one coroutine waits for a database query, HTTP response, or other I/O, the worker can continue other work. This concurrency model runs throughout the framework, letting you write familiar sequential PHP while taking advantage of concurrent execution.
Hypervel is built for traditional web applications, APIs, microservices, real-time services, background workers, and other applications that spend meaningful time waiting on external systems.
Hypervel includes the features expected from a modern full-stack framework:
- Fast, expressive routing and middleware.
- A powerful dependency injection container and service provider system.
- Eloquent ORM, schema building, and database migrations.
- Multiple session and cache stores.
- Background jobs, job batching, and task scheduling.
- Real-time event broadcasting and WebSocket support.
- Authentication, authorization, validation, notifications, mail, and filesystem storage.
- Blade templates and Vite integration for full-stack applications.
- First-class coroutines and concurrent HTTP requests.
- Persistent database and Redis connection pools.
- Coroutine-aware testing, with Testbench for package development.
- gRPC and custom server processes.
Hypervel aims for Laravel API compatibility wherever it fits. However, Hypervel is not a Laravel clone or drop-in replacement. Many Hypervel components are ports of Laravel packages, adapted for Hypervel's asynchronous runtime, performance requirements, and coroutine safety, but the framework itself has its own architecture, features, supported integrations, and direction.
Moving an existing Laravel application or package to Hypervel is a deliberate port, not a namespace replacement. The porting guide explains what needs to change and why.
Hypervel will continue to track and port Laravel features where they fit, while building features designed for Hypervel's runtime. Examples include:
- Native WebSocket support, integrated with Hypervel's routing, middleware, dependency injection, and events.
- Reverb powered by Swoole's built-in WebSocket server, running alongside your application with no separate deployment and scaling across multiple workers.
- gRPC client and server support.
- OpenTelemetry integration for metrics, traces, and logs.
- API integrations and SDKs, built on Hypervel's HTTP client with coroutine concurrency, caching, rate limiting, and Telescope support.
- Typed data objects integrated with request validation, Eloquent, HTTP responses, and contextual dependency injection.
- Role and permission management integrated with Hypervel's authorization system, with explicit allow and deny permissions and tenant partitioning.
- Authentication caching for user lookups, Sanctum tokens, and Passport tokens and clients.
- A Redis session system with user-session management.
- A dedicated rate limiter.
- Layered cache stores.
- Dual-mode Redis cache tags.
- Persistent database and Redis connection pools.
- Object pooling for reusable SDK clients and other expensive objects.
- Aspect-oriented programming (AOP) for intercepting method calls without modifying the target classes.
Built-in integration with SonicStack is also planned. SonicStack is Hypervel's deployment platform and is how we plan to fund ongoing framework development.
Hypervel 0.4 requires PHP 8.4 or later and the official Swoole extension 6.3.0 or later. Hypervel's Redis integrations use the PhpRedis extension 6.1 or later; Predis is not supported.
See the installation documentation for the complete list of required PHP extensions and setup instructions.
This monorepo contains Hypervel's core framework components and first-party packages. Components are developed and tested together here, then published as separate Composer packages. Framework changes and pull requests should be submitted to this repository rather than the split package repositories.
The in-progress Hypervel 0.4 documentation is available here.
Hypervel's documentation follows the structure and style of Laravel's documentation, and portions are adapted from it. Our thanks to the Laravel community.
Thank you for considering contributing to Hypervel. The contribution guide explains which changes are accepted, how to run the required checks, and how to prepare a pull request.
For support questions, ideas, and feature requests, please use GitHub Discussions.
Please review and follow Hypervel's Code of Conduct when participating in the community.
If you discover a security vulnerability in Hypervel, please report it privately by emailing Albert Chen at albert@hypervel.org. Security vulnerabilities will be addressed promptly.
Please do not report security vulnerabilities through public GitHub issues or discussions.
The Hypervel framework is open-sourced software licensed under the MIT license.
Albert Chen |
Raj Siva-Rajah |