OpenSSL头文件缺失导致编译报错，需先验证已安装版本及头文件路径，再正确指定--with-openssl-dir为Homebrew OpenSSL前缀，避免误用二进制路径，并确保PECL源可用及证书有效。
确认 OpenSSL 是否已安装且路径可访问
报 fatal error: 'openssl/ssl.h' file not found，第一反应不是 Swoole 有问题，而是编译器压根没找到 OpenSSL 头文件。先别急着改配置，执行两步验证：
-
brew list openssl或brew list openssl@1.1或brew list openssl@3—— 看你到底装了哪个版本（Apple Silicon 常用openssl@3，Intel 可能是openssl@1.1） -
ls -l $(brew --prefix openssl)/include/openssl/ssl.h—— 直接检查头文件是否存在。如果报 “No such file”，说明路径不对或没装开发头文件
注意：which openssl 返回的是二进制路径（如 /opt/homebrew/bin/openssl），跟编译需要的 include/ 和 lib/ 完全无关，别拿它当 --with-openssl-dir 的值。
指定正确的 --with-openssl-dir 路径
Homebrew 安装的 OpenSSL，头文件实际在 $(brew --prefix openssl)/include，但 --with-openssl-dir 参数只要求填到「包含 include/ 目录的父目录」，即 $(brew --prefix openssl) 本身。
- Intel Mac：
--with-openssl-dir=/usr/local/opt/openssl@1.1（若装的是 @1.1） - Apple Silicon：
--with-openssl-dir=/opt/homebrew/opt/openssl@3（运行brew --prefix openssl@3确认） - 如果用
pecl install swoole交互式安装，在问到enable openssl support?时，输yes后会提示填路径，就填上面那个值，不要加/include或/lib
错填成 /usr/bin/openssl 或 /opt/homebrew/bin/openssl 必然失败——那是运行时二进制，不是开发用的头+库路径。
避免硬拷贝头文件，优先用符号链接或环境变量
有人用 cp -R 把 openssl/include/openssl 拷到 /usr/local/include，短期能过，但下次 brew upgrade openssl 就断掉。更稳妥的做法是：
- 建符号链接：
sudo ln -s $(brew --prefix openssl)/include/openssl /usr/local/include/openssl - 或临时导出编译变量：
CPPFLAGS="-I$(brew --prefix openssl)/include" LDFLAGS="-L$(brew --prefix openssl)/lib" pecl install swoole
后者更干净，不污染系统路径，适合 CI 或多版本共存场景。注意 LDFLAGS 也得带上，否则可能编译通过、运行时报 dyld: Library not loaded: libssl.1.1.dylib。
PECL 通道失效导致根本连不上源（常被忽略）
如果你执行 pecl install swoole 卡在 “No releases available”，或者直接报 Connection timed out，大概率不是网络慢，而是 PECL 客户端 HTTPS 握手失败——OpenSSL 证书过期或缺失。
- 验证：
php -r "print_r(openssl_get_cert_locations());"，看default_cert_file路径是否存在且可读 - 补证书：
wget -c https://curl.haxx.se/ca/cacert.pem -O /usr/local/openssl/cert.pem --no-check-certificate - 国内推荐跳过证书折腾，直接切清华源：
pecl config-set channel_mirror https://mirrors.tuna.tsinghua.edu.cn/pecl/
这个环节一旦失败，pecl install 根本不会走到编译阶段，也就无从触发 openssl/ssl.h 报错——所以看到“找不到 OpenSSL”前先确认 PECL 能否正常拉取包。
真正麻烦的不是路径填错，而是混用不同 OpenSSL 版本（比如 openssl@1.1 编译、openssl@3 运行）或 PHP 与 Swoole 版本不匹配导致的隐性链接失败。建议装完后跑 php --ri swoole | grep OpenSSL，确认输出里明确写了 OpenSSL 版本号，而不是只显示 “enabled”。
