在使用宝塔面板管理Linux服务器时，安装PHP扩展是非常便捷的操作。然而，不少用户在安装Fileinfo扩展时遇到了“显示已安装但实际未生效”的情况。究其原因，通常是因为服务器内存不足导致编译安装中途失败，或者PHP配置文件未正确加载。本文将详细介绍该问题的排查步骤及解决方案。
一、 问题成因分析
Fileinfo扩展在编译过程中非常消耗服务器内存。如果服务器物理内存较小（如1GB或更低），且未配置Swap分区，编译过程可能会被系统直接终止。虽然宝塔面板界面可能随后刷新状态，但实际上扩展并未成功编译生成.so文件，从而导致未生效的问题。
二、 解决方案一：增加Swap分区（推荐）
这是解决内存不足导致安装失败最有效的方法。在安装扩展前，建议先在宝塔面板中添加Swap分区。
操作路径：登录宝塔面板 -> 首页 -> 概览 -> 系统状态 -> 点击“增加Swap”。一般建议设置1024MB或2048MB。添加完成后，再次尝试安装Fileinfo扩展，成功率将大大提高。
三、 解决方案二：手动编译安装
如果通过面板安装失败，可以尝试进入服务器终端，通过命令行手动编译安装。这种方式能够直观地看到报错信息。
首先，我们需要确定PHP的安装路径及版本，以下命令以PHP 7.4为例，请根据实际版本调整路径。
1. 进入PHP源码扩展目录
宝塔面板的PHP源码通常存放在/www/server/php目录下。执行以下命令进入Fileinfo源码目录：
cd /www/server/php/74/src/ext/fileinfo
2. 生成配置文件
执行phpize命令生成configure文件。注意，这里的phpize路径需要对应你正在使用的PHP版本：
/www/server/php/74/bin/phpize
3. 配置编译参数
指定PHP配置文件路径进行配置：
./configure --with-php-config=/www/server/php/74/bin/php-config
4. 编译并安装
执行编译安装命令。如果内存依旧不足，可以尝试加上--jobs=1参数限制并发数，或者再次确认Swap是否开启。
make && make install
编译成功后，终端会提示Installing shared headers或者在结尾处显示生成的fileinfo.so路径。
四、 解决方案三：检查php.ini配置
如果编译成功，但php -m或网页探针中依然看不到Fileinfo，可能是php.ini未加载该扩展。
检查PHP配置文件，通常位于/www/server/php/74/etc/php.ini。查找是否存在类似如下配置：
extension=fileinfo.so
如果该行被注释掉（前面有分号;），请去掉分号；如果不存在，请手动添加该行。添加完成后，务必重启PHP服务：
/etc/init.d/php-fpm-74 restart
五、 验证是否生效
最后，通过命令行验证扩展是否已成功加载：
/www/server/php/74/bin/php -m | grep fileinfo
如果输出结果包含fileinfo，则说明扩展已成功安装并生效。或者在网站目录下创建一个info.php文件，写入<?php phpinfo(); ?>，通过浏览器访问查看Fileinfo模块是否存在。