phpEnv配置移动端适配站点 phpEnv根据UA跳转不同域名设置-php教程-PHP中文网

phpEnv 的 UA 跳转必须由 Nginx 实现，推荐用 map 指令提升性能与可维护性；若需 PHP 兜底，须确保无输出、带协议、及时 exit；Nginx 配置后需重载而非重启。

phpenv配置移动端适配站点 phpenv根据ua跳转不同域名设置

phpEnv 本身不提供内置的 UA 跳转功能，所有域名级跳转必须依赖底层 Web 服务器（Nginx 或 Apache）完成。直接在 PHP 层用 $_SERVER['HTTP_USER_AGENT'] + header() 做跳转，会破坏 SEO、丢失原始请求路径、且无法拦截静态资源请求。

Nginx 配置中用 if + $http_user_agent 判断移动端

这是最常用也最容易上手的方式，适合 phpEnv 默认的 Nginx 环境。注意：不能写在 location 块里嵌套 if，否则可能触发 Nginx 的“unexpected end of file”错误或跳转失效。

进入 phpEnv 对应站点的 Nginx 配置文件（通常位于 /phpenv/nginx/vhost/xxx.conf）
在 server 块内、location / 上方插入如下规则：

if ($http_user_agent ~* "(Android|iPhone|iPad|iPod|Mobile)") {
    return 302 https://m.example.com$request_uri;
}

其中 $request_uri 保留原始路径，避免跳转后丢参数；302 是临时跳转，调试阶段推荐，上线前可改为 301。

保存后，在 phpEnv 控制台点击「重载 Nginx」——不是重启，否则会中断 PHP 进程。

用 map 指令替代 if 提升性能和可维护性

当需要匹配多类 UA（比如微信、钉钉、百度 App、抖音）并分别跳转时，if 会逐条执行正则，而 map 在 Nginx 启动时编译为哈希表，匹配更快，也避免了 if 的作用域陷阱。

编辑全局 Nginx 配置：/phpenv/nginx/conf/nginx.conf
在 http { 块开头、include mime.types; 下方添加：

map $http_user_agent $ua_target {
    default                    "";
    ~*MicroMessenger           "https://example.com/wechat";
    ~*DingTalk                 "https://example.com/dingtalk";
    ~*(Android|iPhone|iPad)    "https://m.example.com";
}

再回到站点配置文件，在 server 块中加一行：

if ($ua_target) {
    return 302 $ua_target$request_uri;
}

注意：map 必须定义在 http 块，不能放在 server 或 location 内；变量名 $ua_target 不能含短横线（如 $ua-target），否则 Nginx 启动失败。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

PHP 层仅做兜底或业务逻辑跳转，不替代 Nginx

某些场景下（例如登录态校验后才决定跳转目标），必须用 PHP 判断。此时需确保：

跳转前未输出任何内容（包括空格、BOM、echo、var_dump），否则报 headers already sent
使用 exit 或 die 终止后续执行，防止页面残留
跳转地址必须带协议（https://），否则变成相对路径跳转，导致 404

示例代码（放在入口文件顶部）：

if (isset($_SERVER['HTTP_USER_AGENT']) && 
    preg_match('/(Android|iPhone|iPad)/i', $_SERVER['HTTP_USER_AGENT'])) {
    header('Location: https://m.example.com' . $_SERVER['REQUEST_URI'], true, 302);
    exit;
}

这种写法只适用于简单判断，且无法跳过 PHP 解析开销——所有请求（包括图片、CSS、JS）都会进 PHP，性能损耗明显。