phpenv无法部署hyperf，因其不支持swoole编译安装及协程所需底层依赖（如glibc、openssl-dev等），导致event loop创建失败或swoole扩展未加载；推荐用系统包管理器+手动编译swoole，或直接使用docker官方镜像。
phpEnv 无法直接部署 Hyperf 的协程环境 —— 它不支持 Swoole 扩展的编译安装，也不提供协程运行时所需的底层依赖（如 glibc 版本、libcurl-dev、openssl-dev 等），强行配置大概率会卡在 swoole 编译或 event loop 启动失败。
为什么 phpEnv 跑不了 Hyperf
phpEnv 是一个基于 shell 脚本的 PHP 多版本管理工具，定位类似 phpbrew，但它默认不集成扩展编译链路，也不接管系统级依赖。而 Hyperf 强依赖 swoole（≥ v4.8.0）且要求开启 --enable-sockets --enable-http2 --enable-openssl 等编译选项；同时需要 pcntl、posix、sysvshm 等扩展启用 —— 这些在 phpEnv 的 install 流程中均不会自动处理。
常见报错包括：
PHP Fatal error: Uncaught Swoole\Exception: event loop has already been createdERROR: extension 'swoole' is not loaded- 执行
php bin/hyperf.php start后立即退出，无日志
想用 Hyperf 就别用 phpEnv 管理 PHP
推荐两条实际可行路径，按优先级排序：
- 用系统包管理器装 PHP + 手动编译 Swoole：
Ubuntu/Debian 上跑apt install php8.1-cli php8.1-dev php8.1-mbstring php8.1-curl php8.1-xml php8.1-zip，再从 swoole-src 下源码，phpize && ./configure --enable-openssl --enable-http2 && make && sudo make install，最后在php.ini加extension=swoole - 改用 Docker 部署：
官方 Hyperf 镜像已预装全部依赖：docker run -v $(pwd):/app -w /app -p 9501:9501 -it hyperf/hyperf:8.1-alpine-cli php bin/hyperf.php start，省去所有环境适配成本
如果非要在 Windows 上本地试 Hyperf
phpEnv 在 Windows 下基本不可用（它依赖 bash 和 GNU 工具链），此时应切换为：
-
laragon或XAMPP+ 手动替换 PHP 为 php.net 官方 Windows 构建版（Thread Safe + x64），再下载对应版本的php_swoole.dll（注意匹配 VC 版本、TS/NTS、PHP 主版本），放进ext/并在php.ini中启用 - 更稳妥的做法：WSL2（Ubuntu 22.04）+ 系统 PHP + 源码编译 Swoole，和 Linux 生产环境完全一致
真正卡住人的从来不是 composer create-project hyperf/hyperf-skeleton 这一行命令，而是 php --ri swoole 输出里有没有 coroutine => enabled 这一栏 —— 其他所有步骤，都是为它服务的。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
