phpenv 不编译或启用扩展,fileinfo 必须在安装 PHP 时用 --enable-fileinfo 编译进源码,或确认 fileinfo.so 存在后修改对应 php.ini 并重启服务;CLI 与 Web 的配置文件常不同,需分别检查并生效。

phpenv 本身不负责编译或启用扩展,它只管理 PHP 版本切换;fileinfo 必须在编译 PHP 时启用,或在已安装版本中通过修改 php.ini 激活(前提是模块文件存在)。
phpenv install 时必须加 --enable-fileinfo
用 phpenv install 安装 PHP,若源码未启用 fileinfo,后续无法通过 php.ini 单独“打开”——因为根本没编译出 fileinfo.so。常见错误是:改了 php.ini、重启了服务,php -m | grep fileinfo 仍无输出。
- 正确做法是在安装命令中显式开启:
phpenv install --configure-options="--enable-fileinfo" 8.2.12 - 如果已装好但没加该选项,只能卸载重装:
phpenv uninstall 8.2.12 && phpenv install --configure-options="--enable-fileinfo" 8.2.12 - 注意:某些旧版 phpenv(如 1.2.x 之前)不支持
--configure-options,需升级 phpenv 或改用php-build手动指定参数
确认 fileinfo.so 是否存在再动 php.ini
即使你用 phpenv 切换到了某个 PHP 版本,也不能默认认为 fileinfo.so 就在扩展目录里。很多预编译包(尤其是 macOS Homebrew 或 Linux 包管理器提供的 PHP)会把 fileinfo 编译进主二进制,不生成独立的 .so 文件——此时 php.ini 里写 extension=fileinfo.so 会直接报错“unable to load dynamic library”。
- 先查扩展目录:
php -r "echo ini_get('extension_dir');" - 再看文件是否存在:
ls $(php -r "echo ini_get('extension_dir');")/fileinfo.so - 如果不存在,但
php -i | grep 'fileinfo support'显示 enabled,说明它是静态编译进 PHP 的,无需也不应写extension=行 - 如果存在,才在 php.ini 里加
extension=fileinfo.so(不要带路径,除非你确定要绝对路径)
phpenv 下多个 php.ini 容易改错位置
phpenv 管理的 PHP 通常有两套配置:CLI 用的和 Web 服务器(如 Apache/Nginx + php-fpm)用的,它们的 php.ini 很可能不是同一个文件。改完 CLI 的 php.ini,php -m 能看到 fileinfo,但 Web 环境仍报错,就是这个原因。
立即学习“PHP免费学习笔记(深入)”;
- 查 CLI 配置:
php --ini→ 看 “Loaded Configuration File” - 查 Web 配置:建个
info.php放 Web 目录,内容为<?php phpinfo(); ?>,访问后搜 “Loaded Configuration File” - 两者都要检查并确保都启用了;fpm 场景下,常要改的是
$(phpenv root)/versions/8.2.12/etc/php-fpm.d/www.conf里的php_admin_value[extension],而非 php.ini
最常被忽略的一点:phpenv 不接管服务进程生命周期。改完配置后,必须手动重启 php-fpm 或 Web 服务器,phpenv rehash 或 phpenv shell 都不会触发重载。别只验证命令行,一定要用 phpinfo() 页面确认 Web 环境真实加载状态。



















