phpEnv Nginx配置实现根据设备(PC/手机)访问不同目录

Nginx 如何根据设备类型（PC/手机）访问不同目录？一份避坑指南

先明确一个核心事实：Nginx 本身并没有内置“手机/PC”的判断逻辑。但别担心，这完全可以通过正则匹配 $http_user_agent 请求头来实现。关键在于，你得用对方法。常见的思路是结合 location 或 if 指令来动态修改 root 目录，但这里有个大坑：if 指令在 location 块内是无法用来重定义 root 的，Nginx 会直接忽略它。

比如，下面这种写法就不会生效：

location / {
    if ($http_user_agent ~* "Mobile") {
        root /var/www/mobile;
    }
}

问题出在哪？root 指令在 if 上下文中的行为是受限的。正确的做法，要么提前用 map 指令预定义变量，要么在 server 块顶层进行条件判断和设置。

推荐方案：用 map 指令预定义 $device_root 变量

要说最干净、性能最佳且被官方推荐的方式，非 map 指令莫属。它在 http 块中定义，全局生效，完美避开了 if 指令的各种陷阱。

具体操作起来很简单。在你的 Nginx 主配置文件（例如 phpEnv 中的 /phpenv/nginx/conf/nginx.conf）或站点配置文件的 http 块内，加入以下映射：

map $http_user_agent $device_root {
    default "/var/www/pc";
    "~*Mobile|Android|iPhone|iPad|iPod|Opera Mini|IEMobile" "/var/www/mobile";
}

定义好变量之后，在对应的 server 块中就可以直接引用了：

server {
    listen 80;
    server_name example.com;
    root $device_root;
    index index.php;

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $device_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

这里有几点必须注意：

• map 块必须放在 http 块内，不能放入 server 或 location。
• 正则匹配使用了 ~* 进行不区分大小写的匹配，default 行则作为 PC 端的兜底路径。
• 最关键的一步：在 PHP 处理块中，SCRIPT_FILENAME 参数也必须使用 $device_root 变量来拼接完整路径，否则 PHP-FPM 会找不到脚本文件。
• 最后，务必确保 /var/www/mobile 和 /var/www/pc 这两个目录真实存在，并且运行 Nginx 的用户（如 www-data 或 nginx）拥有读取权限。

为什么不推荐 try_files + rewrite 方案？

你可能还见过另一种思路：利用 try_files 检查文件是否存在，例如 try_files /mobile/$uri /pc/$uri =404。但这条路基本走不通。

原因在于，try_files 检查的是物理路径是否存在，它无法作为设备判断的逻辑起点。用户完全可能直接输入 /mobile/style.css 这样的 URL，从而绕过你的设备检测逻辑，导致控制权丢失。

更根本的问题是，try_files 不会改变 root 指令的基准路径。所有请求的路径拼接仍然基于原始的 root，这会导致 PHP 脚本的 SCRIPT_FILENAME 计算错误，最终引发 502 或 404 错误。所以，必须从源头——即 root 指令本身——进行控制，而不是依赖后续的文件回退机制。

调试与验证要点

配置写好了，部署时却可能卡住。以下几个点是高频踩雷区：

• 配置生效：修改配置后，务必执行 nginx -t 测试语法，然后通过 nginx -s reload 重载。有时图形化管理界面（如 phpEnv 的面板）的“重启”操作可能不彻底，命令行操作更可靠。
• 测试方法：使用 curl 命令模拟移动端访问是很好的验证方式：curl -H “User-Agent: Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15” http://localhost
• 排查日志：遇到问题时，首先查看 Nginx 的错误日志（例如 /phpenv/nginx/logs/error.log）。如果看到 “Primary script unknown” 这类 FastCGI 错误，几乎可以断定是 SCRIPT_FILENAME 的路径拼接有误。
• 客户端干扰：手机浏览器开启“桌面版网站”模式时，其 User-Agent 会变成 PC 版本，导致请求落入 PC 目录。这并非配置错误，而是客户端行为，测试时需要提醒关闭此选项。

说到底，真正的难点往往不在于写出正确的正则表达式，而在于确保 PHP-FPM 处理的脚本路径与 Nginx 服务的静态资源路径，都严格对齐到同一个 $device_root 变量上。只要有一处忘了替换，整个移动站点的 CSS、JS 和 PHP 文件就可能全部报 404。细节，才是成败的关键。