phpEnv如何修改PHP user_ini.filename phpEnv局部配置

phpenv 不能修改 user_ini.filename，因其仅切换 PHP 版本路径，不干预运行时配置；该指令须在 php.ini 中静态设置且仅对 CGI/FastCGI 生效，CLI 模式下被忽略。

phpenv 本身并不管理 user_ini.filename 这个指令——它只管切换 PHP 版本路径，不负责运行时配置。这个 INI 指令必须在 PHP 启动时加载的 php.ini 文件中设置，而且仅对 CGI/FastCGI SAPI 生效（比如 PHP-FPM 配合 Nginx 的场景）。

为什么 phpenv 无法直接干预

phpenv 本质上是一个 PHP 版本切换器，它的工作很纯粹：把不同版本的 php 二进制文件加入 PATH。至于 PHP 启动之后如何加载配置、读取哪些文件，它完全不过问。而 user_ini.filename 是 PHP 内核级别的 INI 指令，管的是 PHP 是否启用每目录配置文件（比如默认的 .user.ini），以及从哪个文件读取这些配置。这个值必须在 php.ini 里静态定义，没法通过环境变量或者命令行参数动态覆盖。

这里有几个关键点需要注意：

• 你用 phpenv local 8.2 切换版本后，PHP 启动时仍然按该版本的默认路径加载 php.ini，不会自动去读你期望的 .my.ini。
• 即便你在 CLI 下用 php -d user_ini.filename=.my.ini，这条指令也会被忽略——CLI 模式根本不支持 user_ini.filename。
• 在 Web 场景下（比如 Nginx + PHP-FPM），只有当 PHP-FPM worker 进程启动时读取的 php.ini 里面确实设置了 user_ini.filename = ".my.ini"，后续请求才会去扫描 .my.ini。换句话讲，改配置的关键在于 PHP-FPM 启动时加载了正确的 php.ini。

如何让 PHP 实际使用自定义的 user_ini.filename

答案很简单：直接编辑对应 PHP 版本的主 php.ini 文件，别指望 phpenv 替你干这个活。

• 首先确认当前 Web 环境用的是哪个 php.ini：在浏览器里访问 phpinfo() 页面，找到 Loaded Configuration File 这一行。如果是 CLI 调试，可以运行 php --ini 查看——但记住，user_ini.filename 对 CLI 无效。
• 找到路径后，用编辑器打开。比如：sudo nano /usr/local/phpenv/versions/8.2.12/etc/php.ini。
• 搜索 user_ini.filename，取消注释，然后修改为：user_ini.filename = ".my.ini"。
• 顺手检查一下 user_ini.cache_ttl，设置一个合理值（比如 user_ini.cache_ttl = 5 秒）。否则你改了 .my.ini 也要等默认的 5 分钟才能生效。
• 最后，重启 PHP-FPM（用 sudo phpenv restart 或者 sudo systemctl restart php8.2-fpm），不是重启 Nginx。

.user.ini 和 .my.ini 到底差在哪

文件名本身只是个标识，关键在于 PHP 是否识别并加载它。

• 只要 user_ini.filename 设成了 ".my.ini"，PHP 就会在每个请求目录下找 .my.ini，行为和默认的 .user.ini 完全一样。
• 所有写入 .my.ini 的配置项，必须属于 PHP_INI_USER 或 PHP_INI_PERDIR 作用域。比如 upload_max_filesize、post_max_size、date.timezone 这些可以写，但 disable_functions 这类 PHP_INI_SYSTEM 的项，仍然不能写在里面。
• 权限问题也得留意：Web 服务器用户（比如 www-data）必须有读取 .my.ini 的权限，而且这个文件不能放在 Web 可写目录下，避免被覆盖。
• 安全风险也不小：如果没配好 Web 服务器规则，.my.ini 可能被直接下载，暴露配置内容。Nginx 要加一条：location ~ /\.my\.ini { deny all; }。

一个容易被忽略的细节是：改完 php.ini 之后，得确认 PHP-FPM 进程确实 reload 了。别光改了配置，进程还在用旧缓存。另外，.my.ini 的生效延迟由 user_ini.cache_ttl 控制，不是改完立刻就能看到效果。