宝塔PHP扩展安装失败的核心原因是编译环境缺失、源码或开发包未就位、内存不足及配置路径错误；需依次检查并安装基础编译工具、补全PHP源码和-devel/dev包、为fileinfo等扩展添加Swap、写入绝对路径extension并重载服务，最后用php -m和phpinfo双重验证。
宝塔面板PHP扩展安装失败，不是配置点几下就能解决的事。核心问题往往藏在编译链、依赖库或内存资源里。下面按真实排查顺序给出可落地的完整步骤，不绕弯、不跳步。
检查基础编译环境是否齐全
扩展安装卡在 configure 阶段，大概率是缺工具或头文件。
- CentOS/RHEL 系统执行：
yum install -y gcc gcc-c++ make autoconf automake libtool pcre-devel openssl-devel curl-devel libxml2-devel freetype-devel libjpeg-devel libpng-devel sqlite-devel bzip2-devel gmp-devel oniguruma-devel - Ubuntu/Debian 系统执行：
apt-get update && apt-get install -y build-essential libxml2-dev libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev sqlite3 libsqlite3-dev libbz2-dev libgmp-dev libonig-dev - 验证 phpize 是否可用：运行 /www/server/php/74/bin/phpize（把74换成你实际版本号），无报错才说明工具链就位
确认 PHP 源码和开发包已到位
宝塔编译扩展必须依赖 PHP 源码里的 ext/ 目录，而默认极速安装不带源码。
- 检查源码路径是否存在：
ls -l /www/server/php/74/src/ext/fileinfo（路径中74替换成你的版本）
若提示 “No such file”，说明源码缺失 - 补全源码（以 PHP 7.4 为例）：
cd /www/server/php/74 && wget http://cn2.php.net/distributions/php-7.4.33.tar.gz && tar -xzf php-7.4.33.tar.gz && mv php-7.4.33 src - 安装对应版本的开发包：
CentOS 执行 yum install php74-devel（或 yum install php-devel，视系统而定）；
Ubuntu 执行 apt install php7.4-dev
处理 fileinfo 等内存敏感扩展的特殊问题
fileinfo 编译时需加载 magic 数据库，低内存服务器极易失败。
立即学习“PHP免费学习笔记（深入）”；
- 先查看当前内存使用：
free -h，若可用内存低于 512MB，强烈建议加 Swap - 临时创建 2GB Swap 文件（推荐）：
dd if=/dev/zero of=/swapfile bs=1G count=2 && mkswap /swapfile && swapon /swapfile - 再进宝塔「软件商店」→「PHP 7.4 管理」→「安装扩展」→ 勾选 fileinfo，点击安装
- 安装成功后可关闭 Swap：
swapoff /swapfile && rm -f /swapfile
修正配置并重载服务
即使扩展编译成功，没写对配置或没重启服务，依然不生效。
- 确认扩展文件真实存在：
ls -l /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/fileinfo.so - 编辑正确 php.ini：
路径通常是 /www/server/php/74/etc/php.ini，用宝塔文件管理器打开，在 extension 区域添加：
extension = /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/fileinfo.so - 注意：不要写成 extension=fileinfo.so（路径缺失）或 extension=fileinfo.soextension（拼写错误）
- 最后一步必须做：
在宝塔「软件商店」→「PHP 7.4 管理」→「服务」→「重载配置」或「重启服务」
验证是否真正生效
别只看面板显示“已安装”，要用命令和页面双重确认。
- 命令行检测：
/www/server/php/74/bin/php -m | grep fileinfo → 应输出 fileinfo - 网页检测：建一个 phpinfo.php，内容为 <?php phpinfo(); ?>，访问后搜索 “fileinfo”，看到模块信息即成功
- 若仍不显示，检查 php -i | grep "Loaded Configuration File"，确保改的是被加载的那个 php.ini
