phpEnv下安装Swoole须手动源码编译：先确认phpenv version及对应phpize、php-config路径，再./configure --with-php-config=指定路径，make && make install后，在php --ini显示的php.ini中添加extension=swoole.so。
phpEnv 是一个轻量级的 PHP 多版本管理工具，类似 pyenv 或 rbenv，但它不自带 Web 服务、面板或图形界面，也不修改系统级配置。这意味着安装 Swoole 时，你必须手动处理扩展编译、路径匹配和配置加载——稍有偏差就会“明明装了却 php -m 不出来”。
pecl install swoole 在 phpEnv 下大概率失败
phpEnv 管理的每个 PHP 版本都是独立编译的，但默认不启用 pear/pecl 支持：
- 如果执行
pecl install swoole报command not found: pecl，说明当前 phpEnv 版本编译时没加--with-pear； - 即便有
pecl，它也可能调用系统全局的php-config，而不是当前 phpEnv 激活版本的； -
pecl安装后生成的swoole.so路径常被写进错误的extension_dir，导致extension=swoole.so加载失败。
推荐跳过 pecl，直接走源码编译，全程可控。
编译前必须确认的三个路径
phpEnv 的核心陷阱是“你以为在操作 A 版本，实际在动 B 版本”。务必逐条验证：
立即学习“PHP免费学习笔记（深入）”；
- 当前激活的 PHP 版本：运行
phpenv version，例如输出7.4.33 (set by /home/user/.phpenv/version)； - 对应的
phpize路径：通常是~/.phpenv/versions/7.4.33/bin/phpize，不能只写phpize； - 对应的
php-config路径：同上目录下，~/.phpenv/versions/7.4.33/bin/php-config，./configure时必须显式指定； - 扩展目标目录（
extension_dir）：运行php -i | grep "extension_dir"，确认输出路径与make install实际写入位置一致（常见于~/.phpenv/versions/7.4.33/lib/php/extensions/no-debug-non-zts-20190902/这类路径）。
extension=swoole.so 必须写进正确的 php.ini
phpEnv 不会自动创建或修改 php.ini。你得自己：
- 找到当前版本的配置文件：运行
php --ini，看Loaded Configuration File行，例如/home/user/.phpenv/versions/7.4.33/etc/php.ini； - 如果该文件不存在，复制默认模板：
cp ~/.phpenv/versions/7.4.33/etc/php.ini.default ~/.phpenv/versions/7.4.33/etc/php.ini； - 在该
php.ini末尾添加：extension=swoole.so（不要写绝对路径，除非你明确要绕过extension_dir）； - 验证是否生效：运行
php -m | grep swoole，若无输出，再跑php --ri swoole—— 报Extension 'swoole' not present就说明配置没落对地方。
常见报错和对应解法
-
phpize: command not found：说明当前 phpEnv 版本未安装开发支持，需重新编译该版本，加上--with-pear和--enable-maintainer-zts（仅当需要线程安全时）； -
configure: error: Cannot find OpenSSL's <evp.h>：缺 OpenSSL 开发头文件，Ubuntu 执行sudo apt install libssl-dev，CentOS 执行sudo yum install openssl-devel； -
PHP Warning: Module 'swoole' already loaded：同一个swoole.so被多个ini文件重复加载，检查php --ini列出的所有配置文件，删掉冗余的extension=行； -
undefined function go()：说明编译时没启用协程，重跑./configure加上--enable-coroutine参数。
最易被忽略的一点：phpEnv 下的 PHP 默认以 CLI 模式运行，而很多教程测试用的是 Web Server（如 Apache + mod_php）。如果你要在 Nginx/FPM 环境用 Swoole，必须确保 FPM 使用的是同一 phpEnv 版本，并且它的 php-fpm.conf 中 php_admin_value[extension] 或对应 pool 的 php_admin_value[extension] 没有覆盖掉 php.ini 的设置。
