如何有效处理PHP 8.2编译过程中出现的提示信息？

本文共计757个文字，预计阅读时间需要4分钟。

直接安装 zlib1g-dev 常常能够解决问题，但前提是系统已经动过默认路径、没有混用自编译的zlib和交叉编译环境。

为什么装了 zlib1g-dev 还报 “ZLIB not found”

PHP 的 ./configure 脚本靠 pkg-config 查 zlib，不是只看头文件是否存在。常见断点：

• pkg-config --modversion zlib 返回空或报错 → .pc 文件缺失或路径未纳入 PKG_CONFIG_PATH
• 系统有多个 zlib（比如 /usr 和 /usr/local 同时存在），configure 找到了旧版头文件但链接不到对应库
• 你手动编译过 zlib 但没运行 make install，或者用了 --prefix 却没告诉 PHP 去哪找
• 容器或最小化系统里 pkg-config 本身没装（别笑，真有）

确认 zlib 开发包是否真装全了

Debian/Ubuntu 下光 apt install zlib1g-dev 不够，得验证三件事：

• 头文件存在：ls /usr/include/zlib.h（必须有）
• 静态/动态库存在：ls /usr/lib/x86_64-linux-gnu/libz.{a,so}（优先找 libz.so）
• .pc 文件就位：ls /usr/lib/x86_64-linux-gnu/pkgconfig/zlib.pc（没有就手动建软链或重装）

如果 zlib.pc 缺失，重装一次更稳妥：sudo apt install --reinstall zlib1g-dev

立即学习“PHP免费学习笔记（深入）”；

PHP configure 仍找不到 zlib 的应急写法

绕过 pkg-config，显式指定路径：

./configure \ --with-zlib=/usr \ --with-zlib-dir=/usr \ PKG_CONFIG_PATH="/usr/lib/x86_64-linux-gnu/pkgconfig" \ [其他参数]

注意两个细节：

• --with-zlib 和 --with-zlib-dir 在 PHP 8.2 中都有效，但前者优先级更高；填 /usr 表示头文件在 /usr/include、库在 /usr/lib
• 某些旧镜像里 pkgconfig 目录是 /usr/share/pkgconfig，得对应调整 PKG_CONFIG_PATH
• 如果 zlib 实际装在 /usr/local，那就把所有 /usr 换成 /usr/local，并确保 /usr/local/lib 已加入 /etc/ld.so.conf.d/ 并执行 ldconfig

64 位系统上容易被忽略的 -fPIC 问题

如果你自己从源码编译 zlib（而非用系统包），make install 出来的 libz.a 默认不带 -fPIC，PHP 编译共享模块时会报类似：

/usr/bin/ld: /usr/local/lib/libz.a(compress.o): relocation R_X86_64_32 against `a local symbol' can not be used when making a shared object

解决方法只有重新编译 zlib：

cd zlib-1.3.1 CFLAGS="-O3 -fPIC" ./configure --prefix=/usr/local make && sudo make install

之后再编译 PHP，并确保 --with-zlib=/usr/local —— 否则它可能又去拉系统自带的非 PIC 版本。