PHP找不到Swoole扩展的主因是CLI与Web环境php.ini不一致，需分别配置extension=swoole；swoole.so加载失败多因依赖缺失或OpenSSL版本不匹配；class_exists('Swoole\Server')为false通常因PHP与Swoole版本不兼容或编译时禁用了关键组件。
PHP 找不到 Swoole 扩展：确认扩展是否真加载了
直接运行 php -m | grep swoole，如果没输出，说明 PHP 进程压根没加载这个扩展——不是代码写错，是环境没配对。常见原因是 CLI 和 Web（如 Apache/Nginx）用的不是同一个 php.ini。先查清楚你在用哪个 PHP：
- 命令行执行
which php和php --ini，看加载的是哪个配置文件 - Web 环境里建个
info.php，里面写<?php phpinfo(); ?>，浏览器打开，搜 “Loaded Configuration File” - 两个环境的
php.ini很可能不同，extension=swoole得分别加进去
swoole.so 编译成功但加载失败：检查依赖和路径
即使 pecl install swoole 或源码编译显示 success，swoole.so 也可能因缺失动态库而无法载入。运行 php -v 如果报类似 undefined symbol: SSL_get1_peer_certificate 这种错误，大概率是 OpenSSL 版本不匹配或未链接。
- 用
ldd /path/to/swoole.so | grep "not found"检查缺失的 .so 文件 - 常见缺失：
libssl.so.1.1、libnghttp2.so（启用了 HTTP/2 支持时） - 别硬改
LD_LIBRARY_PATH，推荐在php.ini中显式指定完整路径：extension=/usr/lib/php/20220829/swoole.so - Ubuntu/Debian 上装过
php-swoole包？它自带的扩展可能和你自己编译的冲突，删干净再试
启用 Swoole 后 phpinfo() 有模块但 class_exists('Swoole\Server') 返回 false
这说明扩展加载了，但类没注册进来——通常是编译时关掉了关键组件，或者 PHP 版本与 Swoole 版本不兼容。比如 Swoole v5.x 要求 PHP ≥ 8.0，而你用的是 PHP 7.4，哪怕扩展能加载，也会跳过类注册逻辑。
- 查 Swoole 版本兼容表，重点看 PHP 主版本（
php -v输出的第一位）是否匹配 - 编译安装时加了
--disable-http2或--disable-sockets？这些开关会砍掉对应命名空间下的类 - 运行
php --ri swoole，看输出里有没有 “Supports” 列表，确认sockets、openssl、http2是否为 enabled - 某些 Docker 镜像（如
php:8.1-cli）默认没开sockets扩展，得先docker-php-ext-enable sockets
Mac 上用 Homebrew 安装后依然不识别 Swoole
Homebrew 的 php-swoole 是独立 formula，但它默认不自动写入 php.ini，也不保证和 brew 安装的 PHP 主版本对齐。尤其当你用 brew install php@8.2 再装 swoole，容易错配。
立即学习“PHP免费学习笔记（深入）”；
- 先确认当前 PHP 是 brew 装的：
php -v和brew info php对比版本号 - Homebrew 的 swoole 扩展路径通常在
/opt/homebrew/lib/php/pecl/.../swoole.so，手动加到php.ini里 - 别信
pecl install swoole在 Mac 上的默认行为——它可能往系统 PHP（/usr/bin/php）目录写，而你实际用的是 brew 的 PHP - M1/M2 芯片上编译出错？加
--build=arm64参数重装，或换用pecl install swoole+export ARCHFLAGS="-arch arm64"
最麻烦的不是装不上，而是装上了却跑在“半残”状态：扩展存在、函数可用、但协程无法启动，或 Swoole\Http\Server new 不出来。这种时候别急着重装，先盯住 php --ri swoole 和 strace php -r "new Swoole\Server();" 的输出，问题往往藏在那几行没注意的 warning 里。
