php源码编译必须显式添加--with-zlib和--with-libzip参数，否则zlib_decode()、ziparchive等函数缺失或失效；路径错误会导致configure失败或运行时静默错误；opcache与zlib流处理存在边界冲突，需针对性规避。
PHP 编译时没加 --with-zlib，zip 解压必然失败
如果你是从源码编译 PHP（比如用 ./configure），而没显式启用 zlib 支持，那 zlib_decode()、gzopen() 等函数根本不存在，Composer 会直接报 zlib extension is missing 或卡在下载后无法解压。这不是配置问题，是功能缺失。
必须在 configure 阶段加入：--with-zlib。如果系统 zlib 头文件不在标准路径（如 macOS 的 /usr 或 Linux 的 /usr/include），还得指定路径：--with-zlib=/opt/homebrew/opt/zlib（Homebrew）或 --with-zlib=/usr（多数 Linux 发行版）。
- 不加
--with-zlib→ 编译后php -m | grep zlib无输出，function_exists('zlib_decode')返回false - 加了但路径错 → configure 报
zlib not found，编译中断 - 只加
--enable-zip不够 —— zip 扩展依赖 zlib，没 zlib，zip 扩展加载失败或功能残缺
PHP 8.0+ 编译时漏掉 --with-libzip，ZipArchive 就是摆设
ZipArchive 类不是纯 PHP 实现，它底层绑定系统 libzip 库。即使你加了 --with-zlib，若没配 --with-libzip，new ZipArchive() 可能成功，但 extractTo() 会静默失败或报 libzip version too old —— Composer 安装时就卡在 “Failed to extract”。
正确做法是：--with-libzip，并确保系统已安装 ≥1.6.0 的 libzip（pkg-config --modversion libzip 验证）。若 libzip 在非标准路径（如自编译安装到 /usr/local），需加路径：--with-libzip=/usr/local。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
php -r "echo ZIPARCHIVE::VERSION;"返回值→ 绑定的是旧版 libzip，必须重编 - 只启用
extension=zip但没编译支持 →php -m看似有 zip，实际运行时报Class 'ZipArchive' not found或 extract 失败 - Docker 构建中常见错误：基础镜像用了
php:8.2-cli（不含 zip），又没跑docker-php-ext-install zip，导致容器内 Composer 无法解压
别让 --enable-opcache 干扰 zlib 流处理
极少数情况下（尤其 PHP 8.2+ + WSL/Windows），开启 opcache 后，某些流式 ZIP 数据（含数据描述符或 ZIP64）会被意外缓存或截断，导致传给 zlib_decode() 的输入不完整。这不是 opcache 本身 bug，而是其与 zlib 流解析的边界条件冲突。
临时验证方法：编译时去掉 --enable-opcache，或运行时加 php -d opcache.enable=0 composer install。若问题消失，说明需在生产环境做折中——保留 opcache，但通过 COMPOSER_UNZIP=7zip 绕过 PHP zlib 解压路径。
- opcache 开启时，
zlib.output_compression = Off仍必须满足，否则双重压缩干扰更严重 - 这个组合问题在 CI/CD 中难复现，建议本地构建镜像时固定 PHP 编译参数，避免混用不同开关组合
- 不要在 php.ini 里用
opcache.save_comments=0等微调来“修复”，它不解决流数据完整性问题
交叉编译或 Alpine 环境下 zlib 路径容易错位
Alpine Linux 默认用 musl libc，其 zlib 实现和 glibc 系统略有差异；交叉编译（如为 ARM 设备编译 PHP）时，configure 检测 zlib 头文件容易误判。典型表现是 configure 成功，但运行时报 undefined symbol: gzopen64 或 zlib_decode(): data error 即使 ZIP 文件完好。
解决方式不是换版本，而是强制指定头文件和库路径：--with-zlib=/usr/include（Alpine）或 --with-zlib=/usr/arm-linux-gnueabihf/include（ARM 交叉编译），同时加 LDFLAGS="-L/usr/lib" 确保链接器能找到 libz.so。
- Alpine 用户优先用
apk add php82-zip（而非源码编译），它已适配 musl 和当前 libzip - 交叉编译时，
php -r "var_dump(gzopen('/dev/null', 'r'));"是比php -m更早暴露 zlib 链接问题的测试 - 别依赖
find /usr -name "zlib.h"结果 —— musl 下头文件可能在/usr/include/bits/zlib.h，configure 不认
