fileinfo安装失败主因是内存不足或编译配置错误：PHP 8.4编译需至少1GB内存（含Swap），无Swap时make静默被kill；CentOS 7等系统GCC不兼容-std=gnu99，需改Makefile为-std=c99；扩展未生效常因php.ini路径错误、格式不规范或FPM/CLI配置分离，须确认so文件存在、配置纯净且在FPM对应php.ini中启用并重启服务。
fileinfo 安装按钮点不动或反复显示“安装”
这是最常见现象：在宝塔 PHP 8.4 的【PHP扩展】页勾选 fileinfo 后点击【提交】，界面没反应、按钮复原、甚至日志里完全没记录——本质是编译阶段因内存不足直接静默失败。PHP 8.4 编译 fileinfo 需要至少 1GB 可用内存（含 Swap），而很多轻量云服务器（如腾讯云 1C1G）默认无 Swap，make 进程会因 OOM 被系统 kill，但宝塔不报错。
- 先确认内存状态：
free -h查看Swap行是否为0B - 若无 Swap，进宝塔【软件管理】→【Linux工具箱】→【Swap/虚拟内存】，设置大小为
1024MB并启用 - 清理残留缓存：
rm -rf /www/server/php/84/src/ext/fileinfo/.libs /www/server/php/84/src/ext/fileinfo/modules/fileinfo.la - 再回到面板重试启用，此时才会真正触发编译流程
手动编译 fileinfo 时提示 “CFLAGS error” 或 make 失败
宝塔 PHP 8.4 源码中 fileinfo 扩展依赖较新的 C 标准，部分系统（尤其是 CentOS 7）默认的 GCC 不兼容其 Makefile 中的 -std=gnu99 或隐式声明，导致 make 报错类似 error: ‘UINT32_MAX’ undeclared。
- 进入源码目录：
cd /www/server/php/84/src/ext/fileinfo - 清理旧编译：
make clean - 编辑
Makefile，将第一行CFLAGS = -g -O2改为CFLAGS = -std=c99 -g -O2 - 重新构建：
/www/server/php/84/bin/phpize && ./configure --with-php-config=/www/server/php/84/bin/php-config && make && make install
php -m 看不到 fileinfo，但 php.ini 里已写 extension=fileinfo.so
配置写了≠加载成功。常见原因是路径错误、so 文件不存在、或扩展名被重复拼接（比如误写成 extension=fileinfo.so.so）。
- 确认 so 文件真实存在：
ls -l /www/server/php/84/lib/php/extensions/no-debug-non-zts-20240716/fileinfo.so - 打开
/www/server/php/84/etc/php.ini，检查该行是否为纯净格式：extension=fileinfo.so（不能有空格、分号、路径前缀、重复后缀） - 确保该行未被注释（开头不是
;），且位于[PHP]段落内（非[opcache]等其他节） - 执行验证：
/www/server/php/84/bin/php -m | grep fileinfo，只输出fileinfo才算生效
启用后网站仍报 “Fileinfo extension is not loaded”
尤其在 Laravel、WordPress 插件或 Composer 包中出现该提示，说明运行时 PHP-FPM 加载的是另一套配置（比如 CLI 和 FPM 使用不同 php.ini）。
立即学习“PHP免费学习笔记（深入）”；
- 查实际生效配置：
/www/server/php/84/bin/php-fpm -i | grep "Loaded Configuration File" - 对比 CLI 配置：
/www/server/php/84/bin/php --ini，两者路径很可能不同 - 务必在 FPM 对应的
php.ini（通常是/www/server/php/84/etc/php.ini）中添加extension=fileinfo.so - 重启服务必须用面板操作或命令：
service php84-fpm restart（不要只 reload）
别忽略 FPM 与 CLI 配置分离这个点——它让很多人反复验证 php -m 成功，却在线上环境持续报错。
