README

⚡ A modular, async-first PHP framework with native reactive UI and enterprise-grade performance

Hurricane is a modern, high-performance PHP framework ecosystem designed for developers who want to build fast, secure, and scalable applications without the overhead of traditional monolithic frameworks.

It combines a modular backend architecture, Fiber-powered async capabilities, and a server-driven reactive UI layer, enabling you to create everything from portfolio websites and dashboards to API-driven applications with minimal complexity and maximum efficiency.

🧠 Philosophy

Hurricane is built on a simple principle:

Keep the core minimal, make everything modular, and optimize for real-world performance.

No unnecessary abstractions
No heavy bootstrapping
No forced complexity

Instead, Hurricane provides a clean, extensible foundation where each feature is delivered through independent, PSR-compliant packages.

⚙️ Architecture Overview

Hurricane follows a package-driven architecture, where each component is designed as a standalone Composer package:

Core kernel & lifecycle management
PSR-compliant HTTP layer (Request, Response, Middleware)
High-performance routing with caching
Dependency Injection (PSR-11 container)
Validation, security, and database layers
Async I/O engine powered by PHP Fibers
Reactive UI system with minimal JavaScript

This structure ensures flexibility, maintainability, and long-term scalability.

🚀 Key Capabilities

⚡ High Performance by Design

Optimized routing with compiled caching
Minimal kernel overhead
OPcache-friendly architecture
Lazy-loaded services and components

🔄 Async-First Execution

Parallel API requests using Fiber-based concurrency
Non-blocking I/O for external services
Ideal for API-heavy and real-time applications

🔐 Security by Default

Built-in CSRF and XSS protection
Secure session handling and encryption (Sodium)
Rate limiting and brute-force protection
Strict use of prepared statements (PDO)

🧩 Modular Ecosystem

Independent packages for routing, database, auth, caching, and more
PSR-compliant (PSR-4, 7, 11, 15, 18, etc.)
Easily extendable and replaceable components

🎨 Native Reactive UI (Hurricane UI)

Server-driven components with PHP
Async rendering without page reloads
Minimal JavaScript runtime
SEO-friendly server-side rendering

🗄️ Database & API Ready

PDO-based query builder
Support for SQLite, MySQL, PostgreSQL, and more
Built-in API authentication system (token-based)
Optimized queries with indexing strategies

🧑‍💻 Developer Experience

Hurricane is designed to provide a clean and efficient development workflow:

Simple project scaffolding via Composer
Built-in CLI tools for rapid development
Clear folder structure and conventions
Strong typing and modern PHP features (8.2+)

🎯 Use Cases

Hurricane is ideal for:

Portfolio websites and personal projects
Admin dashboards and CRUD applications
API aggregation platforms
Lightweight SaaS products
Headless backend services

🌪️ Final Thought

Hurricane is not just a framework—it’s a modern PHP ecosystem that blends:

Performance + Modularity + Async Power + Simplicity

Build faster, stay secure, and scale confidently—without the weight of traditional frameworks.

hurricanephp / hurricane

Maintainers

Package info

Fund package maintenance!

Statistics

Security