Hyperf 开源项目教程
hyperf项目地址:https://gitcode.com/gh_mirrors/hyp/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
-
克隆项目:
git clone https://github.com/hyperf-cloud/hyperf.git cd hyperf
-
安装依赖:
composer install
-
启动服务:
php bin/hyperf.php start
创建一个简单的 HTTP 服务
-
创建控制器:
php bin/hyperf.php gen:controller IndexController
-
编辑控制器代码:
// 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!']); } }
-
配置路由:
// config/routes.php use Hyperf\HttpServer\Router\Router; Router::addRoute(['GET', 'POST', 'HEAD'], '/', 'App\Controller\IndexController@index');
-
重启服务:
php bin/hyperf.php start
-
访问服务: 打开浏览器访问
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 可以轻松构建高性能、可扩展的分布式系统。