Repository files navigation

English |中文

Hyperf is an extremely performant and flexible PHP CLI framework, powered by a state-of-the-art coroutine server and a large number of battle-tested components. Aside from decisively beating PHP-FPM frameworks in benchmarks, Hyperf is unique in its focus on flexibility and composition. Hyperf ships with an AOP-enabling (aspect-oriented programming) dependency injector to ensure components and classes are pluggable and meta-programmable. All of Hyperf's core components strictly followPSR standards and can be used in other frameworks.

Hyperf's architecture is built using a combination ofCoroutines,Dependency injection,Events,Annotations, andAOP. In addition to providingMySQL,Redis and other common coroutine clients,Hyperf also provides coroutine compatible versions ofWebSocket server / client,JSON RPC server / client,gRPC server / client,Zipkin/Jaeger (OpenTracing) client,Guzzle HTTP client,Elasticsearch client,Consul client,ETCD client,AMQP component,Apollo configuration center,Aliyun ACM,ETCD configuration center,Token bucket algorithm-based limiter,Universal connection pool,Circuit breaker,Swagger,Snowflake,Simply Redis MQ,RabbitMQ,NSQ,Nats,Seconds level crontab,Custom Processes, etc. Therefore, developers can entirely avoid implementing coroutine compatible versions of these libraries.

Rest assured, Hyperf is still a PHP framework. Hyperf provides all the packages you expect:Middleware,Event Manager,Coroutine-optimized Eloquent ORM (and Model Cache!),Translation,Validation,View engine (Blade/Smarty/Twig/Plates/ThinkTemplate) and more.

Although there are many new PHP frameworks, we still haven't found a framework that matches an elegant design with ultra-high performance, nor have we found a framework that paves the way for PHP microservices. With this vision in mind, we will continue to invest in the future of this framework, and you are welcome to join us in contributing to the open-source development of Hyperf.

Hyperspeed + Flexibility = Hyperf. The equation hidden in our name exhibits Hyperf's founding ambition.

Hyperspeed: LeveragingSwoole andSwow coroutines, Hyperf is capable of handling massive amounts of traffic. The Hyperf team made many optimizations to the framework to eliminate every bottleneck between the end-user and our blazing engine.

Flexibility: We believe our Dependency Injection component is best in class. With the help ofHyperf DI, components and classes are all pluggable and meta-programmable. Inversely, all Hyperf components are meant to be shared with the world. Our commitment to PSR standards means that you can use Hyperf components in any compatible framework.

Via these traits, Hyperf has discovered the untapped potential in many fields: implementing Web servers, gateway servers, distributed middleware software, microservices architecture, game servers, and Internet-of-Things (IoT).

• Linux, OS X or Cygwin, WSL, Windows
• PHP 8.1+
• Swoole 5.0+ or Swow 1.4+

Alongside our well-maintained, multilingual documentation, a large number of unit tests for each component ensure logical correctness. BeforeHyperf was released to the public (2019-06-20), it had been privately used by some medium and large Internet companies for multiple services, which have been running without incident for years in harsh production environments.

Official websitehttps://hyperf.io
Documentationhttps://hyperf.wiki

If you discover a security vulnerability within Hyperf, please send an e-mail to the Hyperf Team viagroup@hyperf.io. All security vulnerabilities will be promptly addressed.

This project exists thanks to all the people who contribute. [Contribute].

Become a financial contributor and help us sustain our community. [Contribute]

Support this project with your organization or company. Your logo will show up here with a link to your website. [Contribute]

command:wrk -c 1024 -t 8 http://127.0.0.1:9501/

Running 10stest @ http://127.0.0.1:9501/  8 threads and 1024 connections  Thread Stats   Avg      Stdev     Max   +/- Stdevs    Latency    10.08ms    6.82ms  56.66ms   70.19%    Req/Sec    13.17k     5.94k   33.06k    84.12%  1049478 requestsin 10.10s, 190.16MBreadRequests/sec: 103921.49Transfer/sec:     18.83MB

• 🧬Nano is a zero-config, no skeleton, minimal Hyperf distribution that allows you to quickly build a Hyperf application with just a single PHP file.
• ⚡️GoTask is a library to spawns a go process as a Swoole sidecar and establishes a bi-directional IPC to offload heavy-duties to Go. Think of it as a Swoole Taskworker in Go.
• 🚀Jet is a unification model RPC Client, built-in JSONRPC protocol, available to running in ALL PHP environments, including PHP-FPM and Swoole/Hyperf environments.
• 🧰Box is committed to helping improve the programming experience of Hyperf applications, managing the PHP environment and related dependencies, providing the ability to package Hyperf applications as binary programs, and also providing reverse proxy services for managing and deploying Hyperf applications.

The Hyperf framework is open-source software licensed under the MIT license.