ThinkPHP 的 url() 函数默认生成相对路径，需显式传入 ['domain' => true] 且第三个参数设为 true 才输出完整 URL；反向代理下需配置 trust_proxy 和 url_secure 或手动指定 scheme；多域名场景须手动指定 domain；参数避免双重编码，可使用 raw 选项或预处理解码。
url() 函数默认不带域名，除非显式配置
ThinkPHP 的 url() 函数默认只生成相对路径（如 /index/index/hello），哪怕你已绑定域名（比如通过 APP_DOMAIN 或 Nginx 配置了 example.com），它也不会自动加 https://example.com 前缀。这不是 bug，是设计——多数场景下 URL 应该保持协议中立、环境无关。
要让它输出完整 URL，必须主动告诉框架“我要带域名”。常见做法是传入 ['domain' => true] 参数：
url('index/index/hello', [], true, ['domain' => true])
注意四个参数顺序：地址、参数、是否绝对路径、额外选项。第三个参数设为 true 才会启用绝对路径逻辑，第四个参数里的 domain 才生效。
- 漏掉第三个参数
true，domain选项直接被忽略 - 如果用了 URL 路由重写（如
route.php定义了'hello' => 'index/index/hello'），第一个参数仍应写路由名（'hello'），不是真实方法路径 - 在 CLI 环境下调用时，
domain会 fallback 到$_SERVER['HTTP_HOST']—— 但 CLI 没有该变量，此时需手动配置app.url_domain或在config/app.php中设置'url_domain' => 'https://example.com'
绑定域名后生成 HTTPS 链接容易错在协议判断
即使启用了 domain 选项，url() 默认用的是当前请求的协议（http 或 https）。如果你的 ThinkPHP 运行在反向代理（如 Nginx + SSL 终止）后面，而 PHP 接收到的原始请求仍是 http（因为代理把 HTTPS 解了再转 HTTP 给 PHP），那 url() 就会生成 http://example.com/... —— 明明网站是 HTTPS，链接却跳 http。
立即学习“PHP免费学习笔记（深入）”；
解决方法不是硬编码 https://，而是让框架正确识别协议。关键配置项是 app.url_secure 和 app.trust_proxy：
- 在
config/app.php中设'url_secure' => true，强制所有url()输出https:// - 更稳妥的做法是开启代理信任：
'trust_proxy' => true，并确保 Nginx 转发时设置了Proxy-Protocol或添加X-Forwarded-Proto: https头 - 若用
url()第四个参数临时覆盖，可写：['domain' => true, 'scheme' => 'https']—— 但仅限单点，不适合全局
多域名部署时 url() 不会自动切域名
ThinkPHP 支持多应用或多模块绑定不同域名（如 admin.example.com 绑定 admin 模块），但 url() 不会根据目标控制器自动切换域名。比如你在 www.example.com 下调用 url('admin/index/index')，它仍生成 www.example.com/admin/index/index，而不是跳去 admin.example.com。
这时候不能依赖自动推导，得手动指定目标域名：
url('admin/index/index', [], true, ['domain' => 'https://admin.example.com'])
或者封装一个辅助函数，根据路由规则查表映射域名，避免硬编码散落各处。
- 别指望
url()自动识别admin模块就切到 admin 子域 —— 它只管路由解析，不管域名绑定逻辑 - 如果用了二级域名绑定（
bind.php或route.php的domain规则），这些规则只影响请求入口，不影响url()输出 - 跨域名链接建议统一走配置驱动，比如从
config/domain.php读取'admin' => 'https://admin.example.com'，再拼进url()
生成带参数 URL 时 query 字符串易被重复编码
当传入的参数含中文、斜杠或特殊符号时，url() 会自动 urlencode()，但如果参数本身已经是编码过的（比如前端传来的 %E4%BD%A0%E5%A5%BD），再 encode 一次就变成乱码（%25E4%25BD%25A0%25E5%25A5%25BD）。
常见于从 $_GET 或 API 请求中透传参数再生成跳转链接的场景。
- 检查参数来源：如果是用户输入或外部接口返回，先
urldecode()再传给url()，避免双重编码 - 不要手动拼 query 字符串（如
?name=xxx）传给url()第二个参数 —— 它会当成普通值再 encode 一遍 - ThinkPHP 6.1+ 支持
raw选项：['raw' => true]可跳过对某个参数的编码，但需自行保证安全（如过滤<、"）
最麻烦的其实是调试时看不出问题：生成的 URL 看着正常，点开却 404 或参数丢失。这时候得翻 url() 源码里 buildUrl() 和 encodeParam() 的调用链，确认编码时机和层级 —— 很多坑不在配置，而在参数怎么来的。
