macOS上pecl install swoole报openssl头文件找不到，本质是编译器未搜索Homebrew的openssl头文件路径；需先用brew --prefix openssl确认路径，再建软链sudo ln -s $(brew --prefix openssl)/include/openssl /usr/local/include/openssl，并在交互中输入yes--with-openssl-dir=/opt/homebrew/opt/openssl。
macOS 上 pecl install swoole 报这个错，本质是头文件路径没被编译器看到
不是 OpenSSL 没装，而是 pecl 编译时压根没去查 Homebrew 装的 openssl 头文件在哪。macOS Catalina 后默认不把 /usr/local/include 加入系统头搜索路径，而 Homebrew 安装的 openssl 头文件（比如在 /opt/homebrew/opt/openssl/include）又不在标准位置。
别用 cp -R 硬拷贝头文件到 /usr/local/include —— 下次 brew upgrade openssl 就失效，还得重来。
- 先确认 openssl 实际安装路径：
brew --prefix openssl - 建软链（推荐）：
sudo ln -s $(brew --prefix openssl)/include/openssl /usr/local/include/openssl - 再跑
pecl install swoole，遇到提示时选yes并填上路径，例如：--with-openssl-dir=/opt/homebrew/opt/openssl
手动编译时 configure 找不到 openssl，必须显式传参
./configure 默认不自动探测 Homebrew 或自定义路径下的 openssl，哪怕 which openssl 能输出命令，也不代表头文件和库能被找到。
关键点在于：必须同时启用 --enable-openssl 并指定 --with-openssl-dir，后者要指向包含 openssl/ssl.h 的父目录（即 include 所在路径，不是 include/openssl）。
- 查 openssl include 路径：
find $(brew --prefix openssl) -name "ssl.h" 2>/dev/null，结果类似/opt/homebrew/opt/openssl/include/openssl/ssl.h→ 那么--with-openssl-dir应该填/opt/homebrew/opt/openssl - 运行 configure：
./configure --enable-openssl --with-openssl-dir=/opt/homebrew/opt/openssl --enable-http2 - 千万别加
--without-openssl，否则Co\Http\Client、WebSocket SSL、TLS context 全部不可用
Docker 或 Linux 环境下报同样错误，缺的是开发包不是 openssl 本体
Ubuntu/Debian 系统里 apt install openssl 只装运行时库，不带头文件；CentOS/RHEL 是 openssl-devel。没有这些，#include 必然失败。
- Ubuntu/Debian：
apt-get install -y libssl-dev - CentOS/RHEL：
yum install -y openssl-devel或dnf install -y openssl-devel - 之后再
pecl install swoole或走源码编译流程
验证是否真启用了 OpenSSL 支持，别只看 extension 加载成功
php -m | grep swoole 显示 swoole 已加载，不代表 OpenSSL 功能可用。得看实际支持状态：
- 运行
php --ri swoole，检查输出里是否有openssl => enabled和具体版本号 - 如果写个
Co\Http\Client请求 HTTPS 地址失败，且报SSL operation failed类错误，大概率还是 OpenSSL 没真正链接上 - 注意：MAMP、XAMPP 等集成环境自带的 PHP 可能没编译 OpenSSL 支持，即使你本地 brew 装了 openssl，也得确保
phpize和php-config指向的是你期望的那个 PHP 版本
实际操作中最容易忽略的一点：Homebrew 安装的 openssl@1.1 和 openssl@3 在路径和 ABI 上不兼容，--with-openssl-dir 填错版本会导致编译通过但运行时报段错误或 TLS 握手失败。务必用 brew list openssl 确认当前激活的是哪个版本，再对应填路径。
