根本原因是系统缺少开发头文件或依赖库；需根据报错定位缺失包（如png.h→libpng-dev/devel），补全autoconf等构建工具，检查源码结构、压缩格式、CLI与FPM配置差异及动态链接路径。
宝塔面板编译 PHP 扩展时报 configure: error: not found
根本原因是系统缺少对应开发头文件或依赖库，不是扩展本身的问题。宝塔在后台调用 phpize 和 ./configure 时，会检查底层 C 库是否存在（比如 libpng-dev 对应 PNG 支持，libjpeg-dev 对应 JPEG），缺一个就直接报错中断。
实操建议：
- 先看报错末尾具体缺哪个库，例如
configure: error: png.h not found→ 装libpng-dev（Ubuntu/Debian）或libpng-devel（CentOS/RHEL） - PHP 扩展依赖常和系统发行版强绑定：Ubuntu 用
-dev后缀，CentOS 用-devel，别混用 - 宝塔的 PHP 编译环境默认不装
autoconf、automake、libtool，这些是phpize正常工作的前提，必须手动补全 - 别直接
yum install php-devel就以为万事大吉——它只提供 PHP 头文件，不解决扩展自身的 C 依赖
宝塔里点“安装”后卡住或闪退，日志显示 make: *** No rule to make target `clean'
说明扩展源码包结构异常，或者你上传的压缩包解压后没进到正确子目录（比如 tar 包里套了一层文件夹，但宝塔期望根目录就是 config.m4 和 php_*.c）。
实操建议：
- 下载官方源码后，先本地解压确认路径：必须能看到
config.m4、php_config.h类文件在顶层，否则用tar --transform 's/^php-[^/]*\///' -xzf重打压缩包 - 宝塔调用的是
make clean && make && make install，如果扩展没提供Makefile或Makefile.in，make clean必然失败 - 某些扩展（如
swoole4.8+）已弃用make clean，需手动编辑宝塔的扩展安装脚本，删掉那行make clean - 别用 Windows 压缩软件打包，换
tar -zcf，避免权限位或换行符污染
装完扩展，php -m 看不到，但 phpinfo() 里有，或反过来
本质是 CLI 和 FPM（或 Apache）用的不是同一个 php.ini，宝塔默认只改 FPM 的配置，而命令行调试时走的是 CLI 配置。
实操建议：
- 运行
php --ini查 CLI 加载的 ini 路径，php -r "print_r(php_ini_loaded_file());"查 FPM 实际加载的文件，两者通常不同 - 宝塔界面安装扩展后，只往
/www/server/php/{版本}/etc/php.ini写了extension=xxx.so，但 CLI 可能读的是/usr/local/lib/php.ini或/etc/php/8.1/cli/php.ini - 确认扩展 .so 文件位置：
find /www/server/php -name 'xxx.so'，再核对extension_dir设置是否匹配 - 重启服务要分清：CLI 不需要重启，FPM 要
bt 16或在面板点“重启”，Apache 用户还得 reload httpd
CentOS 7 安装 gd、imagick 等图形扩展总失败
老系统自带的 libjpeg、libpng 版本太低，而新版 PHP 扩展要求 JPEG v9+、PNG v1.6+，但 EPEL 源里的包又不更新，硬装会触发 ABI 冲突或编译警告变错误。
实操建议：
- 别碰系统自带的
libjpeg，直接源码编译高版本：下载jpegsrc.v9e.tar.gz，./configure --prefix=/usr/local/jpeg9 --enable-shared，再ldconfig刷新缓存 - gd 扩展编译时显式指定路径：
./configure --with-jpeg-dir=/usr/local/jpeg9 --with-png-dir=/usr/local/libpng - imagick 依赖 ImageMagick，但宝塔内置的
ImageMagick是精简版，缺 delegate（比如没编译 PDF、SVG 支持），得重装完整版并确保convert -list configure输出含DELEGATES行 - 所有自定义路径的库，都要加进
/etc/ld.so.conf.d/custom.conf并执行ldconfig，否则运行时找不到 so
最麻烦的其实是路径散落和动态链接器缓存不同步，不是代码写错了。多跑两遍 ldconfig -v | grep jpeg，比反复重装快得多。
