最稳妥路径是用brew装PHP再用pecl装Swoole：先确认php -v和php --ini指向brew或MAMP的PHP而非系统自带，再执行pecl install swoole；若报错需检查OpenSSL路径、xcode-select及php.ini扩展配置。
Mac 上装 Swoole 最稳妥的路径是：用 brew 装 PHP，再用 pecl 装扩展——只要终端里 php -v 显示的是 brew 或 MAMP 的 PHP（不是系统自带的），这条路就大概率能走通；否则十有八九会卡在 phpize 报错或找不到头文件。
确认当前 PHP 是谁家的
很多人装失败，根本原因在于终端调用的还是 macOS 自带的 PHP（路径通常是 /usr/bin/php），而它不带 phpize、没有开发头文件、也不能装 PECL 扩展。
- 运行
which php，如果输出/usr/bin/php，说明你正在用系统 PHP —— 别继续往下试了，先切走 - 运行
php --ini，看 Loaded Configuration File 路径：含MAMP或homebrew或Cellar就对了；如果是/etc/php.ini或空白，基本就是系统 PHP - 若需切换到 MAMP：在
~/.zshrc（不是.bash_profile，macOS Catalina 及以后默认用 zsh）加一行：export PATH="/Applications/MAMP/bin/php/php8.2.12/bin:$PATH"（版本号按你实际路径改） - 若用 brew：确保已执行
brew install php，然后检查which php是否指向/opt/homebrew/bin/php（Apple Silicon）或/usr/local/bin/php（Intel）
pecl install swoole 失败的常见报错及解法
pecl install swoole 看似一行命令，但背后依赖 OpenSSL、autoconf、PHP 开发头文件等。报错往往不是 Swoole 本身的问题，而是环境缺东西。
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
-
command not found: pecl→ 先装brew install php（它会自动带pecl）；旧版可能需额外brew install pear -
configure: error: Cannot find OpenSSL's <evp.h>→ brew 安装的 OpenSSL 路径变了，需导环境变量：export LDFLAGS="-L/opt/homebrew/opt/openssl/lib"和export CPPFLAGS="-I/opt/homebrew/opt/openssl/include"（Apple Silicon）；Intel 机器路径是/usr/local/opt/openssl -
phpize: command not found→ 说明 PHP 没装 dev 包，brew 用户重装：brew reinstall php；MAMP 用户确认 bin 目录下有phpize文件 -
grep: /usr/include/php/...: No such file or directory→ Xcode 命令行工具没装全，运行xcode-select --install，再打开macOS_SDK_headers_for_macOS_*.pkg（路径见/Library/Developer/CommandLineTools/Packages/）
编译安装后怎么让 extension 生效
即使 make install 成功，swoole.so 也不会自动加载——必须手动告诉 PHP 去哪找它，且路径必须绝对准确。
- 查 PHP 实际加载的
php.ini：php --ini | grep "Loaded"，别猜，别进 Finder 手动搜 - 查
swoole.so被装到哪了：pecl config-get ext_dir，或看make install最后一行输出（例如Installing '/usr/local/lib/php/pecl/20220829/swoole.so'） - 在
php.ini末尾加一行：extension=swoole（新版 Swoole 支持无后缀写法）；不要写成extension=/full/path/to/swoole.so，容易因路径变更失效 - 改完后重启 Web 服务（如 MAMP 的 Apache/PHP-FPM）或 CLI 重新开个终端，再跑
php -m | grep swoole验证
验证是否真能用，别只看 php -m
php -m 显示 swoole 只代表扩展加载成功，不代表能跑起来。很多问题出在运行时依赖或配置上，比如协程上下文、SSL 支持、信号处理等。
- 快速验证 HTTP Server：
php -r "$s = new SwooleHttpServer('127.0.0.1', 9501); $s->on('start', fn() => print 'ok\n'); $s->start();"，然后curl http://127.0.0.1:9501看是否响应 - 如果报
Class 'SwooleHttpServer' not found，说明扩展没加载，回上一步检查php.ini - 如果报
ERROR swSSL_create: SSL is not supported，说明编译时没链接 OpenSSL，需重装：pecl uninstall swoole && pecl install swoole，并确保之前设好了LDFLAGS/CPPFLAGS - macOS 上用
strace或dtruss调试卡死问题很麻烦，优先用php --ri swoole看编译选项和功能开关状态
最常被忽略的一点：MAMP 和 brew PHP 的 php.ini 是两套，CLI 和 Web 用的也可能是不同 ini 文件；改完一个地方，记得用 phpinfo() 在浏览器里确认 Web 环境是否同步生效。
