报“pcre2.h not found”本质是Homebrew PHP 8.2缺失PCRE2头文件，需执行brew install pcre2并手动软链至include目录，再配合CPPFLAGS/LDFLAGS指定OpenSSL路径，禁用非必要扩展后pecl install swoole方可成功。
pecl install swoole 报 pcre2.h 找不到
这是 macOS M1/M2 上 PHP 8.2 + Swoole 编译最典型的报错，根源是 Homebrew 安装的 PHP 8.2 默认不带 PCRE2 头文件，而新版 Swoole（5.1+）强制依赖 pcre2.h。
- 先确认是否真缺：运行
ls /opt/homebrew/include/pcre2.h（Apple Silicon）或ls /usr/local/include/pcre2.h（Intel），若提示No such file就是它 - 补全头文件：执行
brew install pcre2，然后手动软链（Homebrew 不自动链接到 include 目录）：sudo ln -sf /opt/homebrew/include/pcre2.h /opt/homebrew/include/（M1/M2）sudo ln -sf /usr/local/include/pcre2.h /usr/local/include/（Intel） - 再跑
pecl install swoole，此时应能跳过该错误
configure 阶段报 openssl/ssl.h not found
不是 OpenSSL 没装，而是路径没被编译器识别。Homebrew 的 OpenSSL 路径在 Apple Silicon 上是 /opt/homebrew/opt/openssl，但 phpize 默认不查这个位置。
- 临时导环境变量再 configure：
export LDFLAGS="-L/opt/homebrew/opt/openssl/lib"<br>export CPPFLAGS="-I/opt/homebrew/opt/openssl/include"
- 如果用源码编译，
./configure必须显式指定：./configure --with-openssl-dir=/opt/homebrew/opt/openssl --enable-openssl --enable-http2 - 注意：不要用
--with-openssl简写，必须带-dir参数，否则 configure 会静默跳过 OpenSSL 支持
make 时卡在 php_swoole.lo 或报 hiredis.h 找不到
这类报错本质是依赖头文件缺失，但错误信息指向的是间接依赖——比如 Redis、PostgreSQL、cURL 等可选组件被自动启用，而你本地没装对应开发包。
- 最省事解法：禁用所有非必要扩展，只留核心功能：
pecl install swoole -s --configureoptions="enable-openssl=yes,enable-http2=yes,enable-sockets=yes,enable-mysqlnd=no,enable-redis=no,enable-postgresql=no" - 如果坚持要 Redis 支持，就装
brew install hiredis；要 PostgreSQL 支持，就装brew install libpq - 别信网上“拷
/usr/local/opt/openssl/include/openssl到/usr/local/include”这种老方案——macOS SIP 会阻止写系统目录，且 Homebrew 已弃用该路径
装完 swoole.so 但 php --ri swoole 报 “not found”
说明扩展文件生成了，但 PHP 根本没加载它。Mac 上常见原因是 php.ini 路径错、extension 写法错、或 CLI/FPM 用的不是同一份配置。
立即学习“PHP免费学习笔记（深入）”；
- 先定位 CLI 真正读的 ini：
php --ini | grep "Loaded Configuration File"，输出类似/opt/homebrew/etc/php/8.2/php.ini（brew）或/Applications/MAMP/bin/php/php8.2.12/conf/php.ini（MAMP） - 在该文件末尾加一行：
extension=swoole（PECL 安装）或extension=/opt/homebrew/lib/php/20220829/swoole.so（源码编译，路径以make install终端输出的Installing shared extensions:为准） - Mac 上没有「重启 PHP」按钮，改完后必须：
→ CLI 场景：直接运行php --ri swoole
→ Web 场景：重启 MAMP 或执行brew services restart php
php --ri swoole 显示 enabled 并不等于 file_get_contents() 自动变异步——得在代码开头加 Swoole\Runtime::enableCoroutine()，否则所有协程 API 都不会生效。 
