Hyperf 开源项目教程

1、项目介绍

Hyperf 是一个高性能、灵活的 PHP CLI 框架，特别适用于微服务架构、中间件、Web 系统、API 系统的构建。Hyperf 由 Swoole 和 Swow 提供协程支持，具有极高的性能表现。Hyperf 的核心组件严格遵循 PSR 标准，确保了组件的可插拔性和元编程能力。Hyperf 还提供了丰富的功能包，如中间件、事件管理器、协程优化的 Eloquent ORM、翻译、验证、视图引擎等。

2、项目快速启动

环境要求

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

安装 Hyperf

1. 克隆项目：

   git clone https://github.com/hyperf-cloud/hyperf.git
   cd hyperf
   

2. 安装依赖：

   composer install
   

3. 启动服务：

   php bin/hyperf.php start
   

创建一个简单的 HTTP 服务

1. 创建控制器：

   php bin/hyperf.php gen:controller IndexController
   

2. 编辑控制器代码：

   // app/Controller/IndexController.php
   namespace App\Controller;
   
   use Hyperf\HttpServer\Contract\RequestInterface;
   use Hyperf\HttpServer\Contract\ResponseInterface;
   
   class IndexController
   {
       public function index(RequestInterface $request, ResponseInterface $response)
       {
           return $response->json(['message' => 'Hello, Hyperf!']);
       }
   }
   

3. 配置路由：

   // config/routes.php
   use Hyperf\HttpServer\Router\Router;
   
   Router::addRoute(['GET', 'POST', 'HEAD'], '/', 'App\Controller\IndexController@index');
   

4. 重启服务：

   php bin/hyperf.php start
   

5. 访问服务： 打开浏览器访问 http://localhost:9501，你将看到 {"message":"Hello, Hyperf!"}。

3、应用案例和最佳实践

微服务架构

Hyperf 特别适合构建微服务架构。通过 Hyperf 的依赖注入和 AOP 特性，可以轻松实现服务的解耦和扩展。

中间件

Hyperf 提供了强大的中间件支持，可以用于请求过滤、日志记录、权限验证等场景。

事件管理

Hyperf 的事件管理器可以帮助开发者实现事件驱动的架构，提高代码的可维护性和扩展性。

4、典型生态项目

Hyperf 官方组件

• Hyperf/Database: 协程优化的 Eloquent ORM。
• Hyperf/Cache: 协程安全的缓存组件。
• Hyperf/WebSocket: WebSocket 服务器组件。
• Hyperf/JsonRpc: JSON-RPC 服务组件。

社区贡献

• Hyperf/Swagger: 自动生成 API 文档。
• Hyperf/Apollo: 集成 Apollo 配置中心。
• Hyperf/Consul: 集成 Consul 服务发现。

通过这些组件，Hyperf 可以轻松构建高性能、可扩展的分布式系统。