Swoft 不支持 phpEnv，因其执行模型与 Swoft 的常驻内存、协程驱动、Swoole 深度集成要求根本冲突；可靠运行方式为 Docker（首选）、Composer 创建项目或手动编译 Swoole + 系统 PHP。
phpEnv 不是 Swoft 的推荐或支持环境，也不在官方任何安装文档、Docker 配置或生产部署指南中出现。Swoft 明确要求常驻内存、协程启用、Swoole 扩展深度集成——而 phpEnv 是一个面向传统 FPM/CLI 场景的多版本 PHP 管理工具，无法启动 Swoft 的 HTTP/RPC/WS 服务进程。
直接用 phpEnv 切换 PHP 版本后运行 php bin/swoft http:start 会失败，常见报错包括：
-
Class 'Swoole\Http\Server' not found（Swoole 扩展未加载到当前 phpEnv 激活的 PHP 实例） ERROR: swoole extension is not loaded- 启动后立即退出，无日志，
ps aux | grep swoft查不到进程
为什么 phpEnv 不能跑 Swoft？
根本原因在于执行模型不兼容：
- Swoft 必须由支持协程的 Swoole 扩展驱动，且需在启动时加载全部依赖并常驻内存
-
phpEnv管理的是 CLI/FPM 模式下的 PHP 二进制，它不控制扩展加载逻辑，也不保证swoole.so被编译进对应版本或正确启用（尤其swoole.use_shortname=Off等关键 ini 设置） - 即使手动在
php.ini中启用 swoole，phpEnv切换版本后该配置极易丢失或未生效
真正能跑 Swoft 的三种可靠方式
按稳定性与生产适用性排序：
立即学习“PHP免费学习笔记（深入）”；
-
Docker（首选）：官方镜像
swoft/swoft已预装 PHP 8.0+、Swoole 4.8+、协程全开、自动加载优化。命令一行启动：docker run -p 18306:18306 swoft/swoft -
Composer create-project（开发机主力）：仅需系统级 PHP ≥ 7.4 + 全局可用的
composer，执行：composer create-project swoft/swoft-skeleton myapp，然后cd myapp && php bin/swoft http:start -
手动编译 Swoole + 系统 PHP（Linux/macOS 服务器）：确认
php --ri swoole输出含Coroutine => enabled和Short name => Off，再配好runtime/目录权限和端口占用检查
如果你已装了 phpEnv，现在想试 Swoft
别折腾切换，直接绕过它：
- 查系统默认 PHP：
which php，确保它满足 PHP ≥ 7.4 且php --ri swoole正常输出 - 用这个系统 PHP 运行 composer：
/usr/bin/php $(which composer) create-project swoft/swoft-skeleton myapp - 后续所有
php bin/swoft命令，显式指定完整路径，例如：/usr/bin/php bin/swoft http:start - Windows 用户请放弃
phpEnv，改用 WSL2 或 Docker Desktop
Swoft 的核心约束很硬：不是“PHP 能跑就行”，而是“必须 Swoole 协程就绪 + 进程常驻 + 扩展与配置零误差”。phpEnv 在这个链条里既不参与 Swoole 加载，也不管理进程生命周期，强行套用只会卡在 Class not found 或静默退出——这不是配置问题，是模型冲突。
