宝塔PHP编译失败“configure: error: xxx not found”是因缺少-dev/-devel开发包；链接错误“undefined reference to libiconv_open”需加--without-iconv或指定--with-iconv路径；运行时“error while loading shared libraries”应配置ld.so.conf.d并执行ldconfig；缓存导致重装无效，须清空/src和config.cache后重装。
宝塔面板PHP编译失败提示“configure: error: xxx not found”
这是最常见的情况：宝塔在源码编译PHP时，找不到某个依赖库的头文件或动态库。它不是缺二进制命令（比如 gcc），而是缺开发包（dev package），比如 libxml2-dev、libjpeg-dev 这类带 -dev 后缀的包。
不同系统对应包名不同：apt 系统要装 xxx-dev，yum 或 dnf 系统得装 xxx-devel。漏掉这个后缀，编译必然卡在 configure 阶段。
- Ubuntu/Debian：运行
apt install libxml2-dev libsqlite3-dev libonig-dev libzip-dev libjpeg-dev libpng-dev libfreetype6-dev - CentOS 7：运行
yum install libxml2-devel sqlite-devel oniguruma-devel libzip-devel libjpeg-devel libpng-devel freetype-devel - CentOS 8+/AlmaLinux/Rocky：用
dnf install libxml2-devel sqlite-devel oniguruma-devel libzip-devel libjpeg-devel libpng-devel freetype-devel - 如果报错里提到
libiconv，CentOS 需额外装glibc-static；Ubuntu 则通常自带，不用额外处理
PHP编译报错“undefined reference to `libiconv_open`”
这是典型的链接阶段失败，说明 PHP 检测到了 libiconv 头文件（所以 configure 成功了），但链接器找不到它的符号实现。常见于 CentOS 7+ 和部分 Alpine 环境——系统自带的 glibc 不提供 libiconv，而 PHP 默认又启用了 --with-iconv。
解决思路不是硬塞一个外部 libiconv，而是让 PHP 编译时跳过它，或者明确指定路径。宝塔默认参数里没关 iconv，容易踩坑。
立即学习“PHP免费学习笔记（深入）”；
- 进入宝塔PHP管理页 → 编辑安装配置 → 找到“编译参数”，在末尾追加
--without-iconv - 如果必须用 iconv（比如某些老项目依赖），就先装
libiconv-devel（CentOS）或libiconv-dev（Ubuntu），再加参数--with-iconv=/usr - 注意：加了
--with-iconv却不指定路径，或路径下没有lib/libiconv.so，依然会链接失败
宝塔PHP安装后 php -v 报错“error while loading shared libraries”
说明 PHP 二进制文件编译时链接了某个 .so，但运行时系统找不到它。典型如 libzip.so.5、libonig.so.5 ——这些库被宝塔装在 /www/server/php/xx/lib 下，但系统默认不查这个路径。
这不是 PHP 自身问题，是 Linux 动态库搜索路径没更新。直接改 /etc/ld.so.conf.d/ 最稳妥，比临时设 LD_LIBRARY_PATH 更可靠。
- 确认缺失库名：运行
ldd /www/server/php/xx/bin/php | grep "not found" - 查库实际位置：比如
find /www/server -name "libonig.so*" - 新建配置文件：
echo "/www/server/php/xx/lib" > /etc/ld.so.conf.d/bt-php.conf（把 xx 替换成你装的版本号，如 80） - 立即生效：
ldconfig - 验证：
php -v应该不再报共享库错误
手动装完依赖后宝塔仍反复报同样错误
宝塔的 PHP 编译流程有缓存机制：它会复用之前失败的 configure 结果和中间对象，不会自动重新检测依赖是否已就位。哪怕你刚装完所有 -dev 包，点“重装”也大概率跳过检查，直接从上次断点继续编译。
最有效的方式是清空构建目录，强制它从头走一遍 configure 流程。
- 停掉当前 PHP：在宝塔面板里停止对应版本的服务
- 删构建目录：
rm -rf /www/server/php/src（宝塔默认源码解压在这里） - 删缓存配置：
rm -f /www/server/php/xx/config.cache（xx 是版本号） - 回到面板点“重装”，它会重新下载源码、运行 configure、检查依赖
- 如果还失败，看日志最后一屏：
tail -n 50 /tmp/panelInstall.pl.log，重点找 configure 输出里的 “checking for xxx… no” 行
真正麻烦的从来不是缺哪个库，而是宝塔没告诉你它到底想找哪个路径下的哪个文件。盯住 configure 日志里那句 “no”，比盲装十个包都管用。
