编译PHP时找不到依赖库，90%是系统未安装开发包、路径未配置或pkg-config无法定位.pc文件所致；需先装build-essential（Ubuntu）或Development Tools（CentOS/RHEL），再装libxml2-dev等-devel包，验证pkg-config --modversion，并正确设置PKG_CONFIG_PATH。
编译PHP时找不到依赖库，90%不是PHP的问题，而是系统没装对包、路径没配对、或pkg-config压根不知道库在哪。
configure报错“no acceptable C compiler found”或“make: command not found”
这说明连编译工具链都没齐，根本走不到找依赖那步。
- Ubuntu/Debian：运行
sudo apt update && sudo apt install build-essential（含gcc、make、autoconf等） - CentOS/RHEL 7：运行
sudo yum groupinstall "Development Tools" - CentOS/RHEL 8+ 或 AlmaLinux/Rocky：运行
sudo dnf groupinstall "Development Tools" - 装完后必须验证：
which gcc和which make都得有输出；如果没反应，检查 ~/.bashrc 或 ~/.zshrc 是否被误改，或新开终端再试
configure提示“Package 'libxml2' not found”“No package 'sqlite3' found”
这类错误不是没装 libxml2 或 sqlite3，而是没装带头文件的开发包，或者 pkg-config 找不到 .pc 文件。
- Ubuntu/Debian 必须装
libxml2-dev、libsqlite3-dev、libssl-dev、libcurl4-openssl-dev等，不能只装 runtime 包（如 libxml2、sqlite3） - CentOS/RHEL 对应装
libxml2-devel、sqlite-devel、openssl-devel、curl-devel - 装完后用
pkg-config --modversion libxml-2.0或pkg-config --modversion sqlite3验证是否识别；如果报 command not found，先装pkg-config - 若库装在 /usr/local，但 pkg-config 不认，临时加环境变量：
export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH"
configure通过但make报“undefined reference”或“libzip >= 0.11 not met”
这是链接失败的典型表现，常见于 libzip、libzip >= 1.5.0、或自编译库未被正确暴露给构建系统。
立即学习“PHP免费学习笔记（深入）”；
- 新版 PHP（7.4+）要求 libzip >= 1.5.0，但系统源里常是 1.2.x 或 1.3.1（被PHP明确排除），必须手动编译安装 libzip 1.9.2+
- 编译 libzip 后，确认生成了
libzip.pc，并用find /usr -name libzip.pc 2>/dev/null找到路径；若在 /usr/local/lib/pkgconfig/libzip.pc，就加--with-libzip=/usr/local给 PHP 的 configure - 别依赖
make -j并行编译排错——出错时堆栈混乱，先用make -j1定位第一个真实报错点 - 某些库（如 libzip）没提供 .pc 文件，pkg-config 就查不到；此时 configure 必须显式传路径，不能只靠自动探测
宝塔面板里装PHP扩展失败，提示“找不到 ext 目录”或“PHP源码缺失”
宝塔不保留 PHP 源码，而扩展编译必须读取 ext/ 下的原始代码和 configure 脚本。
- 确认源码路径存在，例如 PHP 8.2 对应的是
/www/server/php/82/src/；若为空，需手动下载同版本源码解压进去 - 下载地址建议用官方镜像：
wget https://windows.php.net/downloads/releases/php-8.2.24.tar.gz（注意换对应版本） - 解压后确保权限可读：
ls -l /www/server/php/82/src/ext | head -3能列出 zip、curl、mysqli 等目录才算正常 - 部分扩展（如 redis、swoole）还依赖系统级共享库，
ldd /www/server/php/82/lib/php/extensions/no-debug-non-zts-20220829/redis.so | grep "not found"可查缺啥，再补装对应 -devel 包或更新ldconfig
最易被忽略的一点：pkg-config 是按 .pc 文件找库的，不是按目录名或 so 文件名。哪怕你把 libzip.so 放进 /usr/lib64，只要没 libzip.pc 或它不在 PKG_CONFIG_PATH 下，configure 就当它不存在——这个逻辑和 Windows 下 DLL 路径查找一样，表面简单，实则极易卡住。
