hyperf/zh/quick-start/install.md

40 lines
1.8 KiB
Markdown
Raw Normal View History

2019-03-17 17:08:45 +08:00
# 安装
2019-03-18 22:36:15 +08:00
## 服务器要求
Hyperf 对系统环境有一些要求,仅可运行于 Linux 和 Mac 环境下,但由于 Docker 虚拟化技术的发展,在 Windows 下也可以通过 Docker for Windows 来作为运行环境。
2019-03-20 14:30:37 +08:00
[hyperf-cloud\hyperf](https://github.com/hyperf-cloud/hyperf) 项目内已经为您准备好了一个 Dockerfile ,或直接基于已经构建好的 hyperf\hyperf 镜像来运行。
2019-03-18 22:36:15 +08:00
当您不想采用 Docker 来作为运行的环境基础时,你需要确保您的运行环境达到了以下的要求:
- PHP >= 7.2
- Swoole PHP 扩展 >= 4.3.1
- OpenSSL PHP 扩展
- JSON PHP 扩展
2019-03-19 13:26:41 +08:00
- PDO PHP 扩展 (如需要使用到 MySQL 客户端)
- Redis PHP 扩展 (如需要使用到 Redis 客户端)
2019-03-30 22:56:57 +08:00
- Protobuf PHP 扩展 (如需要使用到 gRPC 服务端或客户端)
2019-03-18 22:36:15 +08:00
## 安装 Hyperf
2019-03-19 13:26:41 +08:00
Hyperf 使用 [Composer](https://getcomposer.org) 来管理项目的依赖,在使用 Hyperf 之前,请确保你的运行环境已经安装好了 Composer。
2019-03-18 22:36:15 +08:00
2019-03-20 14:30:37 +08:00
### 通过 `Composer` 创建项目
2019-03-20 16:50:33 +08:00
[hyperf-cloud/hyperf-skeleton](https://github.com/hyperf-cloud/hyperf-skeleton) 项目是我们已经为您准备好的一个骨架项目,内置了一些常用的组件及相关配置的文件及结构,是一个可以快速用于业务开发的 Web 项目基础。
2019-03-20 14:30:37 +08:00
执行下面的命令可以于当前所在位置创建一个 hyperf-skeleton 项目
2019-03-19 14:52:21 +08:00
```
2019-03-17 17:08:45 +08:00
composer create hyperf/hyperf-skeleton
2019-03-21 17:30:11 +08:00
```
## 存在兼容性的扩展
2019-03-21 19:38:22 +08:00
由于 Hyperf 基于 Swoole 协程实现,而 Swoole 4 带来的协程功能是 PHP 前所未有的,顾在与不少扩展都仍存在兼容性的问题。
以下扩展(包括但不限于)都会造成一定的兼容性问题,不能与之共用或共存:
2019-03-21 17:30:11 +08:00
- xhprof
- xdebug
- blackfire
- trace
- uopz