tp6如何获取当前请求的完整域名？

Question

在使用 ThinkPHP 6（TP6）开发项目时，如何获取当前请求的完整域名（包括协议头如 `https://` 或 `http://`）是一个常见需求，尤其在生成绝对 URL、处理回调地址或构建 SEO 友好链接时尤为重要。许多开发者尝试通过 `request()->domain()` 或 `request()->url()` 获取完整地址时发现返回结果缺少协议头或路径信息不完整。那么，在 TP6 中，究竟应该如何正确获取包含协议和主机名的完整域名？是否需要结合服务器变量或配置项来确保在不同部署环境（如 Nginx、Apache、负载均衡后端）下都能准确获取？这是实际开发中经常遇到的技术难点。

Answer 1

一、ThinkPHP 6 中获取完整请求域名的常见误区

在 ThinkPHP 6 开发中，许多开发者习惯使用 request()->domain() 方法来获取当前请求的域名。然而，该方法返回的仅是主机名（如 example.com），不包含协议头（http:// 或 https://）。类似地，request()->url() 返回的是包含路径和查询参数的相对 URL，但依然缺失协议信息。

例如：

// 输出：example.com
echo request()->domain();

// 输出：/user/login?token=abc
echo request()->url();
    

这种局限性在需要生成绝对 URL 的场景下显得尤为不足，比如微信 OAuth 回调、支付网关通知地址或 SEO 友好的 canonical 链接构建。

二、从 Request 对象深入解析协议与主机信息

TP6 的 think\Request 类提供了多个方法用于提取请求上下文信息。要获取完整域名（含协议），需结合以下方法：

• request()->scheme()：返回当前请求的协议类型（http 或 https）
• request()->host(true)：返回带端口的主机名（如 example.com:8080）
• request()->domain()：仅返回域名主体，不推荐单独使用

因此，构造完整域名的标准方式为：

$fullDomain = request()->scheme() . '://' . request()->host(true);
// 结果示例：https://example.com:8080
    

三、部署环境差异带来的挑战分析

在真实生产环境中，应用常部署于反向代理（如 Nginx）、负载均衡器或 CDN 后端。此时，原始请求的协议信息可能被代理层修改，导致 scheme() 判断错误（例如始终返回 http）。

常见问题根源在于服务器变量未正确传递。以下是典型代理环境下关键的 HTTP 头字段：

Header 字段	作用说明
X-Forwarded-Proto	指示原始请求使用的协议（http/https）
X-Forwarded-Host	原始 Host 请求头
X-Forwarded-For	客户端 IP 链路
X-Real-IP	真实客户端 IP

四、解决方案：启用信任代理配置以支持多环境兼容

为解决反向代理导致的协议识别问题，TP6 支持通过配置启用“可信代理”模式。需在 config/request.php 中设置：

return [
    // 允许信任的代理 IP 地址
    'trusted_proxies' => ['127.0.0.1', '10.0.0.0/8', '172.16.0.0/12', '192.168.0.0/16'],
    
    // 指定从哪个 HEADER 获取原始协议
    'trusted_headers' => [
        'proto' => 'X-Forwarded-Proto',
        'host'  => 'X-Forwarded-Host',
    ],
];
    

配置后，request()->scheme() 将自动读取 X-Forwarded-Proto 头部，确保 HTTPS 正确识别。

五、封装通用工具函数实现跨项目复用

建议将完整域名获取逻辑封装为助手函数或服务类，提升代码可维护性：

if (!function_exists('get_current_full_domain')) {
    function get_current_full_domain(): string
    {
        $request = request();
        $scheme  = $request->scheme();
        $host    = $request->host(true);

        return $scheme . '://' . $host;
    }
}
    

调用示例：

$url = get_current_full_domain(); // https://api.example.com
    

六、高级场景：结合路由与子域名动态生成绝对链接

在微服务或多租户架构中，常需根据子域名动态生成资源链接。可通过 TP6 路由系统结合域名信息实现：

$subDomain = request()->subDomain(); // 获取子域名部分
$fullUrl = request()->scheme() . '://' . $subDomain . '.example.com';
    

配合路由规则：

Route::domain('api', 'api/');
Route::domain('admin', 'admin/');
    

七、流程图：完整域名获取决策逻辑

graph TD
            A[开始] --> B{是否启用代理?}
            B -- 是 --> C[检查 X-Forwarded-Proto]
            B -- 否 --> D[直接读取 $_SERVER['HTTPS']]
            C --> E[确定 scheme]
            D --> E
            E --> F[获取 host(true)]
            F --> G[拼接 scheme://host]
            G --> H[返回完整域名]

八、测试与验证策略

为确保不同环境下的稳定性，应设计如下测试用例：

1. 本地开发环境（Apache，HTTP）
2. Nginx 反向代理 + HTTPS 终止
3. 云负载均衡（如阿里云 SLB）后端 HTTP 服务
4. Docker 容器网络中的服务暴露
5. CDN 加速场景下源站请求识别
6. 多级代理链路中的头部传递完整性
7. 自定义端口访问（如 :8080）
8. IPv6 主机地址处理
9. WebSocket 请求的协议适配
10. CLI 模式下模拟请求的降级处理