Nginx配置疑问：特定路径满足User-Agent条件后PHP无法执行的解决方法

嗨，这个问题我之前折腾Nginx的时候也碰到过，核心原因就是Nginx的location匹配规则在“搞事情”～

先给你捋明白为啥会出现这个情况：Nginx里的正则表达式location（就是带~或~*的那种）是按配置文件里的书写顺序匹配的，一旦某个正则location匹配上了请求，就会停止往下匹配其他规则。你的第二个location ~ /panel/install/ 会匹配到这个路径下的所有请求，包括.php文件；而这个块里只有User-Agent的校验逻辑，没有处理PHP的配置，所以当UA符合条件时，Nginx就直接把PHP文件当静态资源返回了，自然就触发下载了。

下面给你两个靠谱的解决办法，按需选就行：

方法一：嵌套Location（直观易懂） #

把PHP处理的逻辑嵌套到限制UA的location里，这样既做了UA校验，又能正确处理PHP请求，而且不用重复写太多配置：

# 先处理/panel/install/路径的UA限制，同时嵌套处理该路径下的PHP
location ~ /panel/install/ {
  if ($http_user_agent !~ "agentname") { return 403; }
  
  # 嵌套匹配该路径下的PHP文件，优先级更高
  location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
  }
}

# 处理其他所有路径的PHP请求
location ~ \.php$ {
  include snippets/fastcgi-php.conf;
  fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

这样一来，当请求是/panel/install/xxx.php时，先触发外层的UA校验，通过后再进入内层的PHP处理逻辑，完美解决问题。

方法二：用Map抽离UA校验逻辑（更简洁，避免重复配置） #

如果不想写重复的PHP配置块，可以用Nginx的map模块先定义一个变量，判断UA是否合法，然后在主PHP location里加上路径判断：

首先在server块的开头（或者整个配置的http块里）定义map：

map $http_user_agent $allowed_panel_access {
  default 0;          # 默认不允许访问
  ~*agentname 1;      # 匹配到指定UA就允许（~*是忽略大小写，要严格匹配就换成~）
}

然后修改你的PHP location，加入对/panel/install/路径的校验：

location ~ \.php$ {
  # 仅对/panel/install/下的PHP文件做UA校验
  if ($request_uri ~ ^/panel/install/ && $allowed_panel_access = 0) {
    return 403;
  }
  
  include snippets/fastcgi-php.conf;
  fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}

这种方法把UA校验逻辑抽离出来，不用维护两个PHP配置块，更简洁优雅，我个人更推荐这个方案～

备注：内容来源于stack exchange，提问作者suncat100