ThinkPHP5域名绑定域名带www处理方案-ThinkPHP-PHP中文网

thinkphp5中www子域名必须显式声明，因其route::domain()仅支持http_host精确匹配，不支持通配符或隐式降级；若未配置route::domain('www', 'index')，访问www.example.com将回退默认路由导致模块错乱或404。

thinkphp5域名绑定域名带www处理方案

ThinkPHP5 中 www 子域名必须显式声明，不能靠通配或默认 fallback —— 否则访问 www.example.com 会直接走默认模块（通常是 index），而不是你期望的 PC 端模块。

为什么 `www` 域名不自动匹配？

ThinkPHP5 的 Route::domain() 完全依赖 $_SERVER['HTTP_HOST'] 字符串精确匹配，不支持通配符（如 *.example.com）或隐式降级。如果你只写了 Route::domain('example.com', 'index')，那 www.example.com 就完全不命中，框架会退回到默认路由逻辑，大概率进错模块或 404。

常见错误现象：example.com 正常，www.example.com 却跳到 index/index 或报错 Class not found。

本地开发时，HTTP_HOST 可能是 localhost:8000 或 127.0.0.1:8080，和 www.example.com 毫无关系，必须手动加一条 Route::domain('localhost', ...) 或改 hosts + 浏览器地址栏输入真实域名
线上环境若 DNS 解析了 www，但没在 route/app.php 里声明，就等于没绑定
url_domain_root 配置只影响 URL 生成（如 url() 辅助函数），不影响路由匹配逻辑

`Route::domain('www', ...)` 怎么写才安全？

最稳妥的方式是把 www 当作一个独立子域名来绑定，和 m、api 一样处理。不要试图用正则或条件判断绕开它。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

正确示例（写在 route/app.php 中）：

Route::domain('www', function () {
    Route::get('/', 'index/index/index');
    Route::rule('news/:id', 'index/news/read');
    Route::rule(':name', 'index/user/info');
});
// 或者更简洁的模块绑定
Route::domain('www', 'index');

第二参数必须是闭包或数组，不能是字符串路径（如 'index/index/index'）—— 这会直接报 Invalid route rule
如果同时绑定了 example.com 和 www.example.com，要确保两者逻辑一致，否则用户通过不同入口访问行为不一致
避免和全局 bind('index') 混用：一旦在 app.php 里写了 'bind' => 'index'，再对 www 单独 domain()，会导致模块前缀叠加（比如变成 index\index\controller）

本地测试 `www` 域名必须做的两件事

不改 hosts、不配虚拟主机，www.example.com 在本地根本不会触发 ThinkPHP 的域名路由，因为浏览器发来的 Host 头不是这个值。

编辑系统 hosts 文件（Windows：C:\Windows\System32\drivers\etc\hosts；macOS/Linux：/etc/hosts），添加：
127.0.0.1 www.example.com
Apache/Nginx 必须配置对应虚拟主机，让 Web 服务器把 www.example.com 请求转发到你的项目入口（public/index.php）。否则即使 hosts 对了，Web 服务层就 404 了
浏览器访问时，地址栏必须输 http://www.example.com，不能输 http://localhost 或 IP —— 否则 $_SERVER['HTTP_HOST'] 不匹配