fileinfo是php内置扩展，不可用pecl install安装；应通过源码编译启用：进入ext/fileinfo目录，执行phpize、configure、make && make install，添加extension=fileinfo.so到php.ini并重载服务。
别用 pecl install fileinfo —— 它根本不存在，会报错 Could not find package fileinfo。
pecl 命令压根不支持 fileinfo 扩展
fileinfo 是 PHP 的内置扩展（bundled extension），不是 PECL 社区第三方包。PECL 只管理像 redis、swoole、imagick 这类独立发布的扩展，而 fileinfo 的源码始终随 PHP 源码一起发布在 ext/fileinfo/ 目录下。所以执行 pecl install fileinfo 一定会失败，且没有任何变通参数能绕过这个限制。
为什么有人误以为 pecl 能装 fileinfo
常见混淆来源有三个：
- 把
pecl install imagick的操作习惯套用到所有扩展上 - 看到某些旧文档写“
./configure --enable-fileinfo”，误读成“pecl enable” - 执行
pecl list时没输出，但没意识到这是因它根本不在 PECL 仓库里，而非安装失败
真正该走的路径：编译启用，不是 pecl 安装
如果你的宝塔 PHP 版本（7.2～8.3）源码完整、但面板里没显示 fileinfo 扩展选项，说明它没被编译进当前环境。此时必须手动编译启用，步骤很固定：
- 进入对应 PHP 版本的扩展源码目录：
cd /www/server/php/74/src/ext/fileinfo（把74换成你实际版本号，如81） - 用该 PHP 自带的
phpize初始化：/www/server/php/74/bin/phpize - 配置编译目标：
./configure --with-php-config=/www/server/php/74/bin/php-config - 编译并安装：
make && make install - 确认生成的
fileinfo.so路径（通常在/www/server/php/74/lib/php/extensions/no-debug-non-zts-*下），然后往/www/server/php/74/etc/php.ini里加一行：extension=fileinfo.so - 最后重载 PHP：
bt reloadphp或重启对应 PHP 服务
绕不过去的内存坑：magic.mgc 编译吃内存
fileinfo 编译阶段会调用系统 libmagic 库，并把 /usr/share/misc/magic 编译成二进制 magic.mgc。这个过程峰值内存占用常超 800MB —— 尤其在 512MB 小内存机器上，make 极易被系统 OOM killer 杀掉。解决方法只有两个：
- 提前配好 swap（推荐用宝塔「Linux工具箱」里的 Swap 管理，设 1G～1.5G）
- 或临时注释掉宝塔内存检查逻辑（修改
/www/server/panel/class/common.py中raise Exception('内存不足')那行），但仅限物理内存 ≥1GB 的机器，否则照样失败
记住：fileinfo 不是 PECL 包，它的“安装”本质是本地编译 + 配置加载，和 pecl 完全无关。试图用 pecl 处理它，只会浪费排查时间。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
