phpEnv 无法运行 Swoft，因其依赖 Swoole 扩展且需 CLI 模式独立启动协程服务器，而 phpEnv 仅支持 Apache/Nginx 的 FPM/CGI 传统模式，二者架构根本冲突。
phpEnv 本身不支持 Swoft 运行，因为 Swoft 依赖 Swoole 扩展且必须以 CLI 模式启动服务进程，而 phpEnv 的 Apache/Nginx 模式无法承载协程服务器。
为什么 phpEnv 启动不了 Swoft
Swoft 是基于 Swoole 的全协程 PHP 微服务框架，它不走传统 Web 服务器（如 Apache 或 Nginx）的 CGI/FPM 流程，而是自己监听端口、管理进程、处理 HTTP/WS/TCP 请求。phpEnv 的核心设计是为传统 PHP 应用（如 ThinkPHP、Laravel 的 FPM 模式）提供开箱即用的 Web 服务环境，所有请求最终都经由 httpd.exe 或 nginx.exe 转发给 PHP-CGI，这与 Swoft 的 php bin/swoft start 启动方式根本冲突。
常见错误现象包括：
- 执行
php bin/swoft start后无响应或报错Failed to listen port: 80（端口被 phpEnv 的 Apache 占用） - 浏览器访问提示 502/503，实际是 phpEnv 没有把请求转发给 Swoft
- 控制台报
Class 'Swoole\Http\Server' not found—— phpEnv 当前启用的 PHP 版本未加载swoole扩展
在 phpEnv 环境中启用 Swoole 扩展
即使不能用 phpEnv 管理 Swoft 服务，你仍可借助它提供的 PHP 可执行文件和扩展管理能力来准备运行环境。关键步骤如下：
立即学习“PHP免费学习笔记（深入）”；
- 确认当前 phpEnv 使用的 PHP 版本 ≥ 7.4（Swoft 2.x 要求；Swoft 3.x 推荐 PHP 8.0+）：点击 phpEnv 主界面右下角 PHP 版本号，查看路径，例如
phpEnv\php\php-8.1.12\php.exe - 进入对应 PHP 目录下的
ext文件夹，检查是否存在php_swoole.dll（Windows）；若无，需手动下载匹配版本的 Swoole DLL（注意 x64 / TS / VC17 等标签） - 编辑该 PHP 版本的
php.ini（路径类似phpEnv\php\php-8.1.12\php.ini），添加一行：extension=php_swoole.dll - 重启 phpEnv，点击「PHP Info」按钮验证
swoole是否出现在扩展列表中；若未出现，检查 DLL 文件名是否拼写正确、是否与 PHP 架构完全匹配
绕过 phpEnv Web 服务，直接运行 Swoft
不要试图把 Swoft 放进 phpEnv\www 下并用浏览器访问域名 —— 这条路走不通。正确做法是脱离 phpEnv 的 Web 管理界面，纯命令行操作：
- 打开系统命令提示符（CMD 或 PowerShell），cd 到你的 Swoft 项目根目录（如
D:\projects\swoft-app） - 确保该目录下有
bin/swoft可执行脚本，并已通过composer install --no-dev安装依赖 - 使用 phpEnv 提供的 PHP 解释器运行：
"D:\phpEnv\php\php-8.1.12\php.exe" bin/swoft start -d（-d表示守护进程模式） - 默认监听
http://127.0.0.1:8080，不再走 phpEnv 的 80 端口；如需改端口，在config/properties/app.php中修改'http' => ['port' => 8080] - 若需多项目共存，务必错开端口（如 8081、8082），避免
Address already in use
调试与端口共存注意事项
phpEnv 和 Swoft 能共存，但必须明确分工：phpEnv 管 Apache/Nginx + MySQL + PHP-FPM（用于其他传统项目），Swoft 独占一个 CLI PHP 进程 + 自己的端口 + 自己的协程事件循环。
- 启动 Swoft 前，建议先在 phpEnv 中「停止」Apache 和 Nginx，释放 80/443 端口，避免干扰
- MySQL 服务可以继续由 phpEnv 管理，Swoft 通过配置连接
127.0.0.1:3306即可 - Redis/Memcached 若已由 phpEnv 启动，同样可复用；注意 Swoft 配置中的 host/port 是否匹配
- 开发时常用
php bin/swoft reload热更代码，但 Windows 下对某些文件变更响应较慢，建议配合--watch参数（需安装inotify-win或使用 WSL2 替代）
最易被忽略的一点：Swoft 的 .env 中 APP_ENV=prod 时会关闭调试信息，导致控制台无日志输出 —— 开发阶段务必设为 dev，并检查 runtime/logs 目录权限是否可写。
