[TOC]
## hyperf环境要求
* PHP >= 7.2
* Swoole PHP 扩展 >= 4.5,并关闭了 Short Name
* OpenSSL PHP 扩展
* JSON PHP 扩展
* PDO PHP 扩展 (如需要使用到 MySQL 客户端)
* Redis PHP 扩展 (如需要使用到 Redis 客户端)
* Protobuf PHP 扩展 (如需要使用到 gRPC 服务端或客户端)
## 安装swoole
### 源码安装
> 源码下载地址:https://github.com/swoole/swoole-src/releases
~~~
phpize
./configure --with-php-config=/usr/local/php/bin/php-config
make
make install
~~~
### 或宝塔安装
> 通过`php --ri swoole` 查看swoole安装版本
![截图
](https://img.kancloud.cn/01/b0/01b0a748087e72f92bc6eec32084d720_651x319.png)
### php.ini配置swoole
> 在结尾处加入以下配置
~~~
extension = swoole.so
swoole.use_shortname = off
~~~
## 下载hf初始化项目
> 安装过程中会询问是否安装xx组件,一直按enter到最后
~~~
php ./composer.phar create-project hyperf/hyperf-skeleton
~~~
## 运行项目
> 当运行如下命令后,就可以访问 http://localhost:9501/啦
~~~
php ./bin/hyperf.php start
~~~
## 项目的额外篇
> Protobuf扩展的安装(gRPC通讯时用到,根据实际情况使用)
> Supervisor安装(进程管理器,没有用docker方式的话,建议使用Supervisor),具体参考supervisor篇