先装zlib开发库并确保头文件可见：macOS需执行xcode-select --install或brew install zlib，再用ln软链zlib.h至/usr/local/include，或显式指定--with-zlib-dir；务必重新运行对应PHP版本的phpize以刷新缓存。
configure 报错 “Cannot find libz” 怎么办
这不是 Swoole 自身的问题，而是 PHP 编译阶段找不到 zlib 开发库——libz 是压缩/解压底层依赖，PHP 源码编译（包括 Swoole 的 phpize + ./configure）必须能链接到 zlib.h 和静态/动态库文件。
常见于 macOS 上用 Homebrew 安装 PHP 或手动编译 Swoole 时，尤其在重装 Xcode Command Line Tools 后或新系统初始化阶段。
- 先确认
zlib是否已装：brew list zlib；没输出就运行brew install zlib - 即使已装，Homebrew 的
zlib头文件默认不软链进/usr/local/include，configure 找不到zlib.h。临时解决：ln -s /opt/homebrew/include/zlib.h /usr/local/include/zlib.h（Apple Silicon）ln -s /usr/local/opt/zlib/include/zlib.h /usr/local/include/zlib.h（Intel Mac） - 更稳妥的做法是让 configure 显式知道路径：
./configure --with-zlib-dir=/opt/homebrew/opt/zlib（M1/M2）或--with-zlib-dir=/usr/local/opt/zlib（Intel），路径以brew --prefix zlib输出为准 - 别跳过这步直接加
--without-zlib：Swoole 的Co\Http\Client响应体解压、WebSocket 消息压缩、甚至部分日志写入都依赖 zlib，禁用会导致功能异常或静默失败
为什么 xcode-select --install 有时也能解决
因为 macOS 的 libz 头文件实际由 Xcode Command Line Tools 提供（位于 /Library/Developer/CommandLineTools/SDKs/*/usr/include/zlib.h）。如果系统没装或损坏，configure 就会彻底找不到 zlib.h，连 brew install zlib 都救不了。
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
执行 xcode-select --install 后，系统级头文件路径恢复可用，后续再跑 phpize 和 ./configure 就能自动识别内置 zlib。
- 验证是否生效：
clang -x c -E -dM - 能正常输出即说明工具链就位 - 注意：装完后需重新进入 shell 或运行
hash -r，否则旧的编译缓存可能仍报错 - 如果你用的是 phpEnv 或自编译 PHP，这个步骤比装 brew zlib 更优先——它解决的是“编译器根本看不到任何系统头文件”的根因
Linux 下遇到同样错误？检查 zlib-devel 或 zlib1g-dev
Linux 发行版不会自带编译用的 zlib 头文件包，只装 zlib 运行时库是不够的。
- CentOS/RHEL 8+：
sudo dnf install zlib-devel - CentOS/RHEL 7：
sudo yum install zlib-devel - Ubuntu/Debian：
sudo apt install zlib1g-dev - 确认头文件存在：
find /usr -name "zlib.h" 2>/dev/null，若输出为空，说明包确实没装对
最常被忽略的是：装完开发包后没重新运行 phpize。configure 会缓存上一次 phpize 生成的 config.m4 和 buildconf 结果，旧缓存里没有 zlib 检测逻辑，必须删掉 config.h、configure 等中间文件，再用目标 PHP 的 phpize 重生成。
