根本原因是宝塔PHP为编译安装但缺失开发工具链；需安装autoconf、automake、libtool等，确认phpize/php-config路径正确，补全-devel包，重装PHP或手动指定--with-php-config，检查extension_dir与php.ini路径并重启服务。
PHP 扩展编译失败：找不到 phpize 或报错 Cannot find autoconf
根本原因是宝塔的 PHP 是编译安装的，但没装对应版本的开发工具链。宝塔默认不自带 phpize、autoconf、automake、libtool 这些编译依赖，而手动编译扩展（比如 redis、swoole）第一步就得靠它们生成 configure 脚本。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先确认当前 PHP 版本：
bt 10查看面板里用的是哪个 PHP，再执行/www/server/php/82/bin/php -v（路径中的82换成你实际的版本号，如80、81） - 进对应 PHP 的 bin 目录检查：
ls /www/server/php/82/bin/phpize—— 如果提示 “No such file”，说明缺失，得补全 - 安装基础编译工具（CentOS）：
yum install -y autoconf automake libtool m4 gcc gcc-c++ - 重装 PHP（宝塔界面操作）：选中该 PHP 版本 → “设置” → “编译安装” → 勾选“编译安装（推荐）”，它会自动拉取源码并带上完整 dev 工具链；不要选“极速安装”
编译时提示 configure: error: Cannot find php-config
这是路径没对上。php-config 是 PHP 编译后生成的配置工具，必须和你要装扩展的 PHP 是同一个版本、同一次编译产物。宝塔多 PHP 版本共存时，很容易用错路径。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 别直接运行
php-config，先找对位置：find /www/server/php -name php-config，你会看到类似/www/server/php/82/bin/php-config - 进扩展源码目录后，
./buildconf --force（如有）→./configure --with-php-config=/www/server/php/82/bin/php-config——--with-php-config参数必须写绝对路径，不能省略 - 如果扩展要求特定 PHP 头文件（比如
ext/standard/php.h），确保php-devel包已装（CentOS）或php-dev（Ubuntu/Debian）；宝塔环境下更稳妥的做法是重装一次该 PHP 版本，它会自动部署头文件到/www/server/php/82/include/php/
扩展 make install 成功但 php -m 不显示，或启动报 undefined symbol
常见于扩展依赖了系统级动态库（如 libiconv、libsodium、libzip），但宝塔 PHP 编译时没链接进去，或者运行时找不到 SO 文件。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 检查扩展是否真被复制到正确位置：
ls /www/server/php/82/lib/php/extensions/no-debug-non-zts-20220829/（目录名随 PHP 版本变化，20220829是 PHP 8.2 的 API ID，可用php -i | grep "extension_dir"确认） - 确认
extension=xxx.so写在正确的php.ini里：宝塔每个 PHP 版本有独立php.ini，路径通常是/www/server/php/82/etc/php.ini，不是系统全局那个 - 运行时缺库？用
ldd /www/server/php/82/lib/php/extensions/no-debug-non-zts-20220829/redis.so | grep "not found"查依赖缺失项，然后yum install -y libzip-devel类似补全（注意装-devel版，不是只装libzip） - 改完配置后必须重启 PHP：宝塔界面点“服务” → “PHP-82” → “重启”，不能只 reload 或刷新页面
用宝塔“软件商店”一键安装扩展失败，日志里反复出现 checking for curl... no 或 pkg-config not found
宝塔的一键安装本质也是走编译流程，但它依赖系统 pkg-config 和各类 -devel 包来探测依赖。一旦缺失，就卡在 configure 阶段，且错误信息藏在后台日志里，面板只显示“安装失败”四个字。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先手动装好基础探测工具：
yum install -y pkgconfig（CentOS）或apt install -y pkg-config（Ubuntu） - 根据扩展需求补
-devel包：比如装imagick就要ImageMagick-devel；装gd就要libjpeg-devel libpng-devel freetype-devel - 别跳过“检查依赖”步骤：在宝塔扩展安装页点击“查看日志”，搜
configure:行，看哪一行停住，基本就是缺哪个包 - 某些扩展（如
xlswriter）需要较新 CMake，宝塔 CentOS7 自带太老，得手动升级：curl -L https://github.com/Kitware/CMake/releases/download/v3.25.2/cmake-3.25.2-linux-x86_64.sh -o cmake.sh && sh cmake.sh --prefix=/usr/local --exclude-subdirectory，再加/usr/local/bin到$PATH
which php 和 which phpize 必须逐条确认。 
