php 8.1 安装 swoole 失败主因是系统缺依赖库或 php abi 不匹配；需确认 phpize 与 php-config 同属 8.1 实例、安装 openssl-devel/libssl-dev、显式启用 --enable-sockets/--enable-openssl 等关键编译选项，并选用兼容的 swoole 4.11.x 版本。
PHP 8.1 安装 Swoole 失败，90% 是因为系统缺依赖库或编译时没对齐 PHP ABI —— 不是命令写错了，是环境根本没准备好。
检查 php-config 和 phpize 是否属于同一 PHP 8.1 实例
很多人用 phpize 生成 configure 脚本，却没确认它调用的是哪个 PHP 版本的开发工具。如果系统里装了多个 PHP（比如宝塔自带一个、自己编译一个），phpize 和 php-config 很可能错配。
- 运行
which phpize和which php-config，看路径是否都指向/www/server/php/81/（或你实际用的 PHP 8.1 路径） - 执行
/www/server/php/81/bin/phpize --version和/www/server/php/81/bin/php-config --version，输出必须一致（如都是8.1.27） - 如果
php-config --extension-dir返回的目录里没有swoole.so，说明 make install 写到了别处，不是当前 PHP 在加载的扩展目录
openssl-devel / libssl-dev 缺失导致 configure 报 evp.h 找不到
configure 阶段报 error: Cannot find OpenSSL's <evp.h></evp.h>，不是 OpenSSL 没装，而是开发头文件包没装。系统自带 openssl 命令，但不等于有编译所需的 .h 文件。
- CentOS/RHEL：运行
yum install -y openssl-devel（或dnf install -y openssl-devel） - Ubuntu/Debian：运行
apt-get install -y libssl-dev - 装完仍报错？用
find /usr -name evp.h 2>/dev/null找到路径，显式传给 configure：./configure --with-openssl-dir=/usr/include/openssl - 千万别加
--without-openssl：这会让Co\HTTP\Client、WebSocket SSL、TLS context 全部失效
编译参数没开关键组件，php --ri swoole 显示 supports 全是 disabled
即使 make install 成功，php --ri swoole 输出里 “Supports” 下的 sockets、openssl、http2 全是 disabled，说明 configure 时漏掉了对应开关，不是功能缺失，是编译没启用。
- 必须显式开启：
./configure --enable-sockets --enable-openssl --enable-http2 --with-php-config=/www/server/php/81/bin/php-config -
--enable-mysqlnd要加：否则协程 MySQL 客户端无法使用Co\Mysql - PHP 8.1 + Swoole 4.11.x 是稳定组合；若强行上 Swoole 5.0+，会因 ZTS 兼容问题静默失败（尤其在 Alpine 或某些自定义构建环境中）
php.ini 里 extension=swoole 加对了，但 php -m 不显示
常见于 CLI 和 Web 环境用不同 php.ini，或者扩展路径权限不对。不是“没装上”，是“PHP 进程根本没看到那个 .so 文件”。
- 分别运行
php --ini和php -r "phpinfo();"（Web 环境），对比 “Loaded Configuration File” 路径，两个环境都要加extension=swoole - 确认
php-config --extension-dir返回的目录下真有swoole.so，且属主可读（ls -l看权限，避免是 root 写入、php-fpm 用户无权读） - 不要写
extension=swoole.so：PHP 会自动补.so，写全反而在 Windows 下出错；也不要写成extension=/full/path/swoole.so，除非你明确需要多版本隔离
最常被忽略的一点：Swoole 的 Co\WaitGroup、Co\Socket 等类，在 Swoole 4.8.0 之前压根不存在。PHP 8.1 装了个老版本 Swoole（比如 4.5.x），代码里用了新 API，运行时报 Class not found —— 这不是环境问题，是版本锁没做对。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
