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免费学习笔记（深入）”；
