phpEnv默认不启用fileinfo扩展，需手动取消php.ini中extension=fileinfo注释、确认extension_dir路径正确、重启phpEnv服务，并用php -r "var_dump(function_exists('finfo_open'));"验证是否生效。
phpEnv 默认不启用 fileinfo 扩展，而 WordPress、Laravel 等应用在上传文件时会调用 finfo_open() 检测 MIME 类型；若扩展未加载，$_FILES['error'] 可能返回 UPLOAD_ERR_CANT_WRITE (7) 或静默失败——这不是权限或大小问题，而是扩展缺失导致的写入中断。
确认 fileinfo 是否已启用
执行以下命令检查当前 PHP 是否加载了该扩展：
php -m | grep fileinfo
如果无输出，说明未启用。不要只看 phpinfo() 页面里有没有，要以 CLI 输出为准（phpEnv 的 CLI 和 Web 使用同一配置）。
-
php -v确认你操作的是 phpEnv 当前激活的 PHP 版本（如 8.1、8.2） - 对应扩展目录通常在
/phpenv/php/lib/php/extensions/no-debug-zts-xxxxx/，里面应有fileinfo.so（Linux/macOS）或php_fileinfo.dll（Windows） - 若找不到该文件，说明编译时未启用 —— phpEnv Windows 版多数预编译包默认关闭
--enable-fileinfo
Windows 下手动启用 fileinfo（phpEnv 常见路径）
phpEnv Windows 版本的 php.ini 通常位于 /phpenv/php/etc/php.ini。打开后搜索 ;extension=fileinfo，去掉分号并保存：
立即学习“PHP免费学习笔记（深入）”；
extension=fileinfo
注意：不是 extension=php_fileinfo.dll，phpEnv 的 Windows 预编译包使用短名方式加载。
- 确保
extension_dir指向正确路径，例如：extension_dir = "D:/phpenv/php/lib/php/extensions/no-debug-zts-20210902"（路径需与你实际版本号匹配） - 修改后必须重启整个 phpEnv：运行
phpenv restart，不能只 reload Nginx - 验证是否生效：
php -r "var_dump(function_exists('finfo_open'));"应输出bool(true)
Linux/macOS 下编译启用（phpEnv 源码安装场景）
如果你是通过源码编译安装的 phpEnv（非一键包），需重新编译 PHP 并显式开启：
./configure --enable-fileinfo ...其他原有参数...
然后执行 make && make install。跳过此步直接改 php.ini 会报错：PHP Warning: PHP Startup: Unable to load dynamic library 'fileinfo'。
- 编译前先
apt install libmagic-dev（Debian/Ubuntu）或yum install file-devel（CentOS/RHEL），否则 configure 会跳过 fileinfo - 编译完成后，
php -i | grep "fileinfo"应显示 “fileinfo support => enabled” - 别忘了同步检查
upload_tmp_dir是否存在且可写——fileinfo缺失时，PHP 可能无法安全识别上传文件类型，进而拒绝写入临时目录
为什么开了 fileinfo 还上传失败？重点查这三点
即使 fileinfo 已启用，上传仍可能卡在 100% 或报 HTTP 错误，此时真正瓶颈往往不在 PHP 层：
- Nginx 的
client_max_body_size未设或太小（常见值为 1M），它在请求进入 PHP 前就拦截了大 body，日志里会出现413 Request Entity Too Large - WordPress 的
wp-content/uploads目录归属仍是admin:admin，而 phpEnv 的 Nginx + PHP-FPM 进程用户是www，chown -R www:www .必须执行，且不能只改uploads目录 -
upload_tmp_dir指向的路径（如C:\Windows\Temp或/tmp）对www用户不可写——尤其 Windows 下 SYSTEM 账户创建的 Temp 子目录，www默认无权限
fileinfo 是上传链路中容易被忽略的一环：它不报错，但会让 PHP 在 move_uploaded_file() 前就放弃处理。修完扩展，务必用 var_dump($_FILES) 看 error 值是否变成 0，再排查后续环节。
