phpenv不内置swoole，需为每个php版本手动编译安装并启用--enable-coroutine；协程可用需php≥7.4且configure时显式指定--enable-coroutine，验证需测试go()函数是否存在及正常调度。
phpEnv 本身不内置 Swoole，也不能直接“开启”扩展——它只是 PHP 版本管理工具，Swoole 必须作为独立扩展编译安装到每个被 phpEnv 管理的 PHP 实例中。协程环境是否可用，取决于你安装的 Swoole 是否启用了 --enable-coroutine，以及 PHP 版本是否 ≥ 7.4（推荐 ≥ 8.0）。
确认 phpEnv 管理的 PHP 路径和版本
先搞清你实际在用哪个 PHP：
- 运行
phpenv versions查看已安装版本，比如显示* 8.1.27 - 执行
which php或phpenv which php，确认路径类似~/.phpenv/versions/8.1.27/bin/php - 检查版本：
~/.phpenv/versions/8.1.27/bin/php -v，确保 ≥ 7.4 - 注意：phpEnv 不自动配置
php.ini路径，需手动定位 —— 运行~/.phpenv/versions/8.1.27/bin/php --ini，输出中的 “Loaded Configuration File” 才是你要编辑的文件
为 phpEnv 管理的 PHP 编译安装 Swoole（含协程）
不能靠 pecl install swoole 轻易搞定，因为 phpEnv 下的 PHP 往往缺失 php-config 或头文件路径不标准，容易装到错位或禁用协程。必须显式指定路径：
- 下载源码（以 Swoole v5.1.3 为例）：
wget https://github.com/swoole/swoole-src/archive/refs/tags/v5.1.3.tar.gz - 解压并进入：
tar -zxvf v5.1.3.tar.gz && cd swoole-src-5.1.3 - 用目标 PHP 的
phpize生成配置：~/.phpenv/versions/8.1.27/bin/phpize - configure 时严格绑定：
./configure --with-php-config=~/.phpenv/versions/8.1.27/bin/php-config --enable-coroutine --enable-openssl - 编译安装：
make && make install，成功后会输出类似Installing shared extensions: /home/xxx/.phpenv/versions/8.1.27/lib/php/extensions/no-debug-non-zts-20210902/ - 编辑对应
php.ini，末尾加一行：extension=swoole.so - 验证：
~/.phpenv/versions/8.1.27/bin/php -m | grep swoole，有输出即加载成功
测试协程是否真可用（不是只加载了扩展）
仅 extension=swoole.so 不代表协程就 ready —— 常见错误是 configure 漏掉 --enable-coroutine，导致 go() 报 Fatal error: Uncaught Error: Call to undefined function go()：
- 写一个最小测试脚本
test_coro.php：
<?php if (!extension_loaded('swoole')) {
die("swoole extension not loaded\n");
}
if (!function_exists('go')) {
die("coroutine functions (go, co::sleep) not available — check --enable-coroutine during compile\n");
}
go(function () {
echo "coro start\n";
\co::sleep(0.1);
echo "coro end\n";
});
echo "main exit\n";
- 用 phpEnv 指定版本运行：
~/.phpenv/versions/8.1.27/bin/php test_coro.php - 正确输出应为三行（顺序可能交错）：
coro start、main exit、coro end - 若报
Call to undefined function go()，说明编译时没启用协程，必须重装；若卡住不动，可能是co::sleep()未触发调度器，检查是否漏了co\run()包裹（但go()在 CLI 下可自动启动调度器）
运行 Swoole HTTP 服务脚本的注意事项
在 phpEnv 环境下直接运行 php server.php 是可行的，但要注意几个隐性坑：
- 务必使用全路径调用 PHP，例如
~/.phpenv/versions/8.1.27/bin/php server.php，否则可能调用系统默认 PHP（没装 Swoole） - 不要在
server.php中依赖$_SERVER或传统 CGI 变量 —— Swoole HTTP Server 是独立进程，不走 PHP-FPM - 端口占用常见：默认
9501可能被占，改用'port' => 8088更稳妥 - 调试时设
'daemonize' => false，否则日志看不到，出错直接静默退出 - 修改代码后必须手动 kill 进程再重启，Swoole 不自带热重载
最易被忽略的一点：phpEnv 切换版本后，php -m 显示的模块列表可能还是旧版本的缓存，一定要用 ~/.phpenv/versions/x.y.z/bin/php -m 精确验证，而不是依赖 shell alias 或未指定路径的 php 命令。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
