Apache2.4+PHP-FPM FastCGI：Alias下.user.ini无法递归的问题求助

云上老周

2026-7-6

解决Alias指向文档外路径时.user.ini无法递归生效的问题

很多人都碰到过这个情况：当用Alias把请求指向文档根目录之外的项目路径时，.user.ini没法递归生效，但把项目移到文档根里就正常。核心原因是PHP的.user.ini扫描逻辑默认只认DOCUMENT_ROOT对应的路径，Alias指向的外部目录不会被自动识别为合法的扫描范围。

下面分两种主流Web服务器给出解决办法：

Apache环境

在你的Alias配置块里，明确给外部目录开启Override权限并强制启用.user.ini扫描：

Alias /your-alias /path/to/external/project
<Directory /path/to/external/project>
    AllowOverride All
    php_admin_value user_ini.filename ".user.ini"
    Require all granted
</Directory>

AllowOverride All让Apache允许该目录下的配置规则生效，确保PHP能读取到.user.ini
php_admin_value强制指定该目录的.user.ini文件名，避免全局配置被覆盖
记得给外部目录设置正确的权限，让PHP进程能读取里面的文件

Nginx+PHP-FPM环境

Nginx默认不会把Alias路径传递给PHP作为DOCUMENT_ROOT，所以得手动指定，同时强制启用.user.ini：

location /your-alias {
    alias /path/to/external/project;
    fastcgi_pass unix:/run/php/php7.4-fpm.sock; # 换成你的PHP-FPM套接字或端口
    fastcgi_param SCRIPT_FILENAME $request_filename;
    fastcgi_param DOCUMENT_ROOT /path/to/external/project;
    fastcgi_param PHP_ADMIN_VALUE "user_ini.filename=.user.ini";
    include fastcgi_params;
}