fileinfo扩展在phpEnv中默认未启用，需手动取消php.ini中;extension=fileinfo的注释、确认php_fileinfo.dll存在且extension_dir路径正确，再重启Web服务并用phpinfo()验证Loaded Configuration File路径，确保CLI与Web SAPI加载同一配置。
fileinfo 扩展在 phpEnv 中默认未启用，但 Laravel 的 Storage::putFile()、文件上传 MIME 类型校验、Intervention Image 等组件强依赖它——不开启会导致 “Unable to guess the mime type” 或 500 错误。
确认当前 PHP 版本和 php.ini 路径
phpEnv 是多版本共存环境，不同 PHP 版本对应独立的 php.ini，必须先定位到你项目实际使用的版本配置文件：
- 打开终端，执行
php -v查看当前 CLI 使用的 PHP 版本（如 8.1） - 执行
php --ini，输出类似：Configuration File (php.ini) Path: D:\phpEnv\php\php-8.1\Loaded Configuration File: D:\phpEnv\php\php-8.1\php.ini - 注意：Apache / Nginx 模块运行的 PHP 可能加载的是另一份
php.ini（常为php.ini-development或php.ini-production），需检查 Web 服务器重启后生效的配置 —— 最稳妥方式是新建info.php放入 Web 目录，访问并搜索 “Loaded Configuration File”
启用 fileinfo 扩展（Windows 下 phpEnv 常见操作）
phpEnv 的 PHP 二进制包通常已内置 php_fileinfo.dll，只需取消注释扩展行并确保 DLL 存在：
- 用记事本或 VS Code 打开上一步确认的
php.ini - 搜索
;extension=fileinfo（注意分号表示注释），改为extension=fileinfo（PHP 8.0+ 可省略.dll后缀） - 检查
extension_dir是否指向正确路径，例如：extension_dir = "D:\phpEnv\php\php-8.1\ext"
并确认该目录下存在php_fileinfo.dll - 保存后，**必须重启 Web 服务（Apache/Nginx）和 PHP-FPM（如启用）**，仅重启浏览器或重载页面无效
验证 fileinfo 是否生效
别只信 php -m | findstr fileinfo，CLI 启用 ≠ Web 环境启用：
立即学习“PHP免费学习笔记（深入）”；
- 创建
test_mime.php文件，内容为：<?php<br>var_dump(extension_loaded('fileinfo'));<br>var_dump(finfo_open(FILEINFO_MIME_TYPE)); - 通过浏览器访问该文件（如
http://localhost/test_mime.php） - 预期输出：
bool(true)resource(1) of type (fileinfo)
若第二行报错Call to undefined function finfo_open()，说明扩展未在 Web SAPI 中加载成功 - Laravel 中可临时在
routes/web.php加一行测试：Route::get('/finfo', fn() => response()->json(['loaded' => extension_loaded('fileinfo')]));
常见失败原因和绕过陷阱
很多用户反复修改 php.ini 仍不生效，问题往往不在扩展本身：
- 改错了
php.ini：phpEnv 里可能有多个php.ini（CLI 用一个，ApacheLoadModule指定另一个），务必以phpinfo()显示的 “Loaded Configuration File” 为准 - 扩展名写错：旧版 PHP 需写
extension=php_fileinfo.dll，新版统一用extension=fileinfo；写成extension=file_info或extension=FileInfo都会静默失败 - 权限或路径含空格/中文：若
extension_dir路径含中文或空格（如D:\Program Files\...），Windows 下某些 PHP 版本无法加载 DLL，建议 phpEnv 安装路径全英文、无空格 - Apache 模块未重载：修改
php.ini后，必须执行httpd -k restart（或通过 phpEnv 控制面板点“重启 Apache”），而非仅刷新页面
fileinfo 不是“开了就完事”的扩展——它依赖系统级 magic 数据库，phpEnv 自带的 magic 文件若损坏或缺失（常见于手动替换 PHP 文件夹），finfo_open() 仍可能返回 false。此时需检查 php.ini 中 mime_magic.magicdb 配置项，或直接删掉该行让 PHP 使用内置 magic 数据。
