ThinkPHP如何配置基于域名的负载均衡 ThinkPHP域名代理与后端服务-ThinkPHP-PHP中文网

thinkphp 不能直接做域名级负载均衡，它只是应用层框架，需依赖 nginx、haproxy 或云厂商 slb 等反向代理实现；其自身仅负责根据 http_host 路由分流、识别真实域名并生成正确 url。

thinkphp如何配置基于域名的负载均衡 thinkphp域名代理与后端服务

ThinkPHP 能不能直接做域名级负载均衡

不能。ThinkPHP 是应用层框架，不处理 TCP/HTTP 流量分发，nginx、haproxy 或云厂商的 SLB 才是干这事的。你看到的“ThinkPHP 配置域名负载”，实际是：前端反向代理把不同域名请求转发到不同后端服务（可能是多个 ThinkPHP 实例），而 ThinkPHP 本身只需正确识别当前请求的原始域名，避免生成错误的 URL 或跳转。

为什么 `$_SERVER['HTTP_HOST']` 在代理后会出错

当用 nginx 或 alb 做域名代理时，真实客户端的 Host 头默认不会透传给后端 PHP 进程——尤其在未配置 proxy_set_header Host $host; 的情况下，$_SERVER['HTTP_HOST'] 可能变成上游 IP 或 localhost，导致 Url::build() 生成内网地址、验证码图片 404、登录态跨域失效等。

必须在反向代理配置中显式透传 Host：proxy_set_header Host $host;
如果用了 HTTPS 终止，还需加：proxy_set_header X-Forwarded-Proto https;
ThinkPHP 中启用信任代理头：在 config/app.php 加 'trusted_host' => ['*'],（生产环境建议写具体 IP 段）
验证是否生效：打印 var_dump($_SERVER['HTTP_HOST']);，应显示用户访问的真实域名（如 api.example.com）

多域名共用同一套 ThinkPHP 代码时如何路由分流

不是靠服务器负载均衡决策，而是靠 ThinkPHP 在入口层根据 HTTP_HOST 主动分发请求到不同模块或控制器。适用于「一个代码库支撑多个子站」场景（如 shop.example.com 和 admin.example.com）。

btpanel phpsite 宝塔面板PHP网站

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

下载

在 public/index.php 入口最上方加判断，不走默认 think\App 启动流程：

if (strpos($_SERVER['HTTP_HOST'], 'admin.') === 0) {
    define('BIND_MODULE', 'admin');
} elseif (strpos($_SERVER['HTTP_HOST'], 'shop.') === 0) {
    define('BIND_MODULE', 'shop');
}

确保各模块有独立路由定义（app/admin/route.php 等），且不互相冲突

注意静态资源路径：CSS/JS 中的相对地址不受影响，但 url() 助手函数需配合 __ROOT__ 或配置 url_domain_root

Session 和 Cookie 域名需统一设为 .example.com，否则子域名间无法共享登录态

后端服务部署时域名与端口映射常见坑

负载均衡器把 api.example.com 转发到 192.168.1.10:8080，但 ThinkPHP 默认生成的 URL 还是带 :8080，或者协议仍是 HTTP——这不是框架 bug，是它没被告知真实对外信息。

强制指定对外域名和协议：在 config/app.php 中设置 'url_domain_root' => 'https://api.example.com'
若使用 Url::build() 生成完整 URL，必须开启 'url_build_cache' => false，否则缓存会固化错误 host
检查 $_SERVER['SERVER_PORT'] 是否被代理覆盖：某些 LB 会把端口设为 80/443，即使后端监听非标端口；此时不要依赖该值拼接 URL
调试技巧：在控制器里打印 request()->domain() 和 request()->url(true)，确认输出是否符合预期