hyperf是基于swoole的高性能协程框架，需先安装php 8.0+、swoole扩展（≥5.1.1）并验证协程启用，再通过composer create-project hyperf/hyperf-skeleton一键创建项目，2分钟内即可启动访问。
Hyperf 本身是基于 Swoole 的高性能协程框架，但 不能直接通过“安装 Swoole 扩展”就“秒级搭建 Hyperf”。Swoole 是底层依赖，Hyperf 是上层应用框架，二者关系类似“引擎与整车”——装好引擎不等于车能开。真正快速启动 Hyperf，需要的是标准化的环境准备 + 官方脚手架命令，而非仅靠扩展本身。
确认 Swoole 已正确安装并启用
Swoole 必须以 shared 模式编译进 PHP（非 embed 或 static），且版本需匹配 Hyperf 要求（如 Hyperf v3.1 推荐 Swoole ≥ 5.1.1）。验证方式：
- 运行 php -m | grep swoole，应有输出
- 运行 php --ri swoole，检查 version、support async_redis、coroutine 等关键项为 enabled
- 若无输出或报错，需重新编译安装 Swoole：pecl install swoole（推荐）或源码编译后配置 extension=swoole.so 到 php.ini
用 Composer 快速创建 Hyperf 项目
Hyperf 官方提供 hyperf/hyperf-skeleton 作为最小可用模板。在已装好 PHP（≥8.0）、Composer（≥2.2）、Swoole 的 Linux 环境中，执行以下命令即可生成可运行项目：
- composer create-project hyperf/hyperf-skeleton myapp
- cd myapp && php bin/hyperf.php start —— 启动后默认监听 http://127.0.0.1:9501
- 整个过程通常在 1–2 分钟内完成，前提是网络通畅、Composer 镜像已切至国内源（如阿里云）
避免常见“秒级失败”陷阱
看似简单，但以下问题常导致启动失败或行为异常：
- PHP 版本不兼容：Hyperf v3.x 不支持 PHP 7.x，必须用 PHP 8.0+；检查用 php -v
- 缺少必要扩展：除 swoole 外，还需 json, mbstring, xml, curl, openssl, pcntl, posix；缺失任一都会在 composer install 或启动时报错
- 权限或端口冲突：Linux 下若非 root 用户启动，默认 9501 端口可能被占用；可改用高编号端口：php bin/hyperf.php start --port=9502
- 未启用协程 Hook：Hyperf 默认开启全协程化，但某些自定义扩展或旧代码可能干扰；首次运行建议保持默认配置，勿提前修改 config/autoload/server.php 中的 settings.enable_coroutine
不复杂但容易忽略。只要 Swoole 就位、PHP 环境干净、Composer 源靠谱，Hyperf 确实能做到“两分钟从零到访问首页”。
