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.
The published documentation at hypervel.org/docs currently covers Hypervel 0.3. 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, opinionated PHP framework built for Swoole. It runs applications in long-lived workers and uses coroutines to handle many requests, jobs, and connections concurrently.
When one coroutine is waiting on a database query, cache lookup, queue operation, file access, or HTTP request, the worker can keep serving other requests and jobs instead of sitting idle. You write ordinary sequential code, and the runtime yields to other work while yours waits.
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. The dedicated rate limiter, dual-mode Redis cache tags, layered cache stores, and Redis session system with user-session management are examples of that direction.
First-party ClickHouse support and built-in integration with SonicStack are 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 Swoole 6.2.2 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 complete Hypervel documentation is available at hypervel.org/docs.
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 |