宝塔编译PHP扩展报“libpng not found”是缺开发包而非运行库，需装libpng-devel（CentOS）或libpng-dev（Ubuntu），并确认PHP源码目录存在、ext子目录可读及php.ini配置正确。
宝塔编译PHP扩展时提示“libpng not found”是缺-devel包，不是缺libpng命令
报错里出现 libpng not found 或 configure: error: png.h not found，说明 configure 阶段找不到头文件 png.h，不是系统没装 libpng 运行库，而是缺开发包（libpng-devel 或 libpng-dev）。直接 yum install libpng 或 apt install libpng 没用，它只装运行时 SO 文件，不带头文件和 pkgconfig 描述。
- CentOS/RHEL/AlmaLinux/Rocky：运行
yum install -y libpng-devel（7）或dnf install -y libpng-devel（8+） - Ubuntu/Debian：运行
apt install -y libpng-dev - 如果同时装 imagick、gd、gmp 等扩展，建议一并补全：
libjpeg-devel+freetype-devel+libxml2-devel（RHEL系）或对应-dev包（Debian系）
为什么装了libpng-devel还是报错？检查PHP源码目录和权限
即使依赖装全，宝塔在软件商店点安装仍卡住，常见原因是 PHP 源码目录被清理过，或 ext 子目录不可读。宝塔编译扩展时会从 /www/server/php/82/src/ext/ 下拉取原始扩展代码，再调用 phpize 生成 configure —— 如果这个路径不存在或为空，就根本走不到依赖检查那步。
- 确认源码存在：
ls -d /www/server/php/82/src（把82换成你实际版本号），若报 “No such file”，需手动恢复：cd /www/server/php/82 && wget https://windows.php.net/downloads/releases/php-8.2.20.tar.gz && tar -xzf php-8.2.20.tar.gz && mv php-8.2.20 src - 检查 ext 权限：
ls -l /www/server/php/82/src/ext | head -3，确保能看到gd、curl等子目录，且属主不是nobody - 某些 OpenVZ 或精简镜像会禁用
phpize，执行/www/server/php/82/bin/phpize看是否返回 “Cannot find config.m4”——如果是，说明源码缺失或损坏
libpng相关扩展（如gd、imagick）安装后仍不生效的典型陷阱
扩展编译成功、.so 文件已落盘，但 php -m | grep gd 无输出，或网站报 Call to undefined function imagecreatefrompng()，问题往往不在 libpng 本身，而在 ABI 不匹配或配置未加载。
- 确认 extension_dir 路径正确：
php -i | grep extension_dir输出应为类似/www/server/php/82/lib/php/extensions/no-debug-non-zts-20220829/；该目录名中的20220829是 PHP 8.2 的 API ID，不能复用其他版本的.so - 检查
php.ini是否真写了extension=gd.so：宝塔有时只写进 FPM 配置（/www/server/php/82/etc/php-fpm.conf），而 CLI 用的是另一份（/www/server/php/82/etc/php.ini），需分别确认 - 权限必须是
644且属主为root：ls -l /www/server/php/82/lib/php/extensions/no-debug-non-zts-20220829/gd.so；若属主是www或权限是600，PHP Worker 无法读取
libpng版本冲突导致PHP启动失败怎么办
极少数情况（尤其在自定义编译或混用第三方源时），系统装了多个 libpng 版本（如 /usr/lib64/libpng.so.16 和 /usr/local/lib/libpng.so.15），PHP 编译时链接了旧版，运行时报 undefined symbol: png_set_longjmp_fn 或直接 segfault。
立即学习“PHP免费学习笔记（深入）”；
- 先定位问题 SO：
ldd /www/server/php/82/bin/php | grep png，看它实际链接的是哪个路径 - 若指向
/usr/local/lib且该路径下版本过旧，临时移除干扰：mv /usr/local/lib/libpng.so* /tmp/，再ldconfig - 更稳妥做法是重装 PHP：在宝塔面板中选中该版本 → 设置 → 编译安装（勾选“编译安装(推荐)”），它会强制使用系统默认 repo 的 libpng-devel，并静态绑定版本
宝塔对 libpng 的依赖判断非常“诚实”：它不关心你系统里有多少个 .so，只认编译那一刻 pkg-config --cflags libpng 返回的头文件路径和 libpng.pc 里声明的链接参数。一旦中间有缓存、软链错位或源码残留，就容易卡在看似简单的问题上。
