PHP扩展编译失败时configure: error提示缺依赖，是指系统缺少该扩展所需的开发头文件、库或编译工具链，如hiredis-devel、libjpeg-dev、pkg-config等，需手动安装对应依赖及基础编译环境。
PHP扩展编译失败时，configure: error 提示缺依赖是啥意思
宝塔面板里点“安装”PHP扩展却卡在编译阶段，终端刷出类似 configure: error: xxx not found 或 checking for xxx... no，这基本不是宝塔的问题，而是系统缺少该扩展依赖的开发头文件或工具链。比如装 redis 扩展报 checking for hiredis.h... not found，说明没装 hiredis-devel（CentOS）或 libhiredis-dev（Ubuntu/Debian）；装 imagick 却提示 not found pkg-config，其实是连 pkg-config 这个基础构建工具都没装。
常见依赖缺失现象包括：
-
checking for jpeg_read_header in -ljpeg... no→ 缺libjpeg-devel（CentOS）或libjpeg-dev（Ubuntu） -
configure: error: Please reinstall the libcurl distribution→ 缺libcurl-devel或libcurl4-openssl-dev - 直接报
command not found: make或gcc: command not found→ 没装基础编译环境
宝塔里装扩展前，必须手动检查的 3 个环境项
宝塔不会自动帮你装系统级依赖，它只负责调用 phpize、./configure、make 这套流程。所以装扩展前得自己确认底层是否就绪：
-
编译工具链是否完整：运行
gcc -v、make -v、autoconf -v、pkg-config --version，任一报错就得先装。CentOS 执行yum groupinstall "Development Tools"；Ubuntu/Debian 执行apt install build-essential autoconf automake pkg-config -
PHP 开发头文件是否存在：宝塔 PHP 的源码目录通常在
/www/server/php/{版本号}/src，进这个目录看有没有main/、Zend/等子目录。如果为空或不存在，说明当初编译 PHP 时没保留源码，后续扩展无法编译——此时要么重装 PHP（勾选“编译安装”并保留源码），要么改用pecl install方式（部分扩展支持） -
扩展本身依赖的库是否已安装且可被找到：比如
pdo_sqlsrv需要微软的msodbcsql17和mssql-tools；swoole4.8+ 推荐启用openssl和nghttp2支持，就得提前装好对应 dev 包
pecl install 能绕过宝塔界面失败吗？适用场景和限制
当宝塔前端点击安装一直失败，可以 SSH 登录后手动用 pecl 尝试。它不依赖宝塔的构建逻辑，而是走 PECL 官方分发的包（部分为预编译，部分仍需编译）。但要注意：
立即学习“PHP免费学习笔记（深入）”；
- 必须用对应 PHP 版本的
pecl命令，比如 PHP 8.1 的 pecl 在/www/server/php/81/bin/pecl，别直接敲pecl（可能调用系统默认 PHP 的） - 有些扩展如
redis、memcached支持pecl install redis直接装；但像ioncube、suhosin（已废弃）这类闭源或特殊加载方式的，pecl不支持 - 若
pecl install也报错，错误信息往往更具体，比如ERROR: The DSP php_redis.dsp does not exist，说明当前 PHP 版本与扩展版本不兼容，得换低版本扩展或升 PHP - 装完后需手动加
extension=redis.so到php.ini，并确认extension_dir路径正确——宝塔不会自动写配置
为什么装完扩展 PHP 仍不识别？extension_dir 和 .so 路径最容易错
编译成功、重启 PHP 后 php -m | grep redis 还是没输出？大概率是 extension 指令指向了错误路径，或者 .so 文件根本不在 extension_dir 下。
查清实际路径的方法：
- 运行
/www/server/php/81/bin/php-config --extension-dir（把 81 换成你实际版本），这是 PHP 编译时记录的默认扩展目录 - 去这个目录下看有没有生成的
redis.so（或对应扩展名），没有就说明编译产物被放到别处了，比如/www/server/php/81/lib/php/extensions/no-debug-non-zts-20210902/—— 这个时间戳目录才是真实extension_dir - 编辑
/www/server/php/81/etc/php.ini，确认extension_dir值和上面查到的一致，并在下方加extension=redis.so（不要写绝对路径，除非你明确要用） - 改完后执行
/etc/init.d/php-fpm-81 reload（不是 restart），再用php -m验证
一个常被忽略的细节：宝塔多个 PHP 版本共存时，每个版本的 php.ini 是独立的，改错文件等于白干。
