Symfony无法识别HTTPS的根本原因是FrankenPHP经Caddy TLS终止后以HTTP转发请求，且未透传X-Forwarded-Proto头；需在Caddyfile中添加header X-Forwarded-Proto "https"，并在Symfony配置trusted_proxies并清缓存。
FrankenPHP 能直接跑 Symfony 并自动配好 HTTPS，但 Symfony 的 isSecure()、generateUrl() 生成的 URL 会出错——根源不在 FrankenPHP，而在 Symfony 没收到正确的 TLS 信号。
为什么 Symfony 认不出 HTTPS 请求
FrankenPHP 用 Caddy 处理 TLS 终止后，把请求以 HTTP 协议（非 HTTPS）转发给 PHP 内部处理层。Symfony 默认只看 $_SERVER['HTTPS'] 或端口是否为 443，而 FrankenPHP 不设 HTTPS=on，也不改 $_SERVER['SERVER_PORT']，导致 $request->isSecure() 返回 false，所有 url() / path() 生成的链接都是 http:// 开头。
- 典型现象：
dump($request->isSecure())输出false，即使浏览器地址栏显示https:// - 影响范围：登录跳转、CSRF token 生成、资产 URL（如
asset('css/app.css')）、邮件中生成的绝对链接 - 根本原因：Caddy 的反向代理行为不透传 TLS 状态，FrankenPHP 未默认注入
X-Forwarded-Proto: https
必须加的 Caddyfile 配置项
在站点块里显式设置转发头，告诉 Symfony “上游是 HTTPS”：
{ frankenphp { num_threads auto } }
yourdomain.com {
encode zstd br
header X-Forwarded-Proto "https"
header X-Forwarded-SSL "on"
php_server
}-
header X-Forwarded-Proto "https"是关键，Symfony 的Request::createFromGlobals()会读它判断安全状态 -
X-Forwarded-SSL是部分旧版 Symfony（如 5.4 之前）的兼容 fallback，建议保留 - 不要写
header_up X-Forwarded-Proto {http.request.header.X-Forwarded-Proto}—— 这是 Caddy 的 reverse_proxy 语法，php_server不走 proxy 流程，无效 - 如果用了子路径部署（如
/app），还需加header X-Forwarded-Prefix "/app"，否则路由匹配可能偏移
Symfony 端要启用信任代理
仅靠 Caddy 发头还不够。Symfony 默认忽略所有 X-Forwarded-* 头，必须显式配置信任：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
在 config/packages/framework.yaml 中添加：
framework:
trusted_proxies: '%env(TRUSTED_PROXIES)%'
# 或硬编码（仅限开发/测试）
# trusted_proxies: ['127.0.0.1', '::1']- 环境变量方式更安全：
TRUSTED_PROXIES=127.0.0.1（FrankenPHP 和 Caddy 同进程，源 IP 总是本地回环） - 别用
trusted_hosts替代——它只校验 Host 头，不解决协议判断 - 若用 Docker，且 Caddy 在容器外，需填宿主机 IP 或容器网关地址（如
172.17.0.1） - 检查是否生效：在控制器里
dump($request->getScheme());应输出https
验证和容易漏掉的点
做完上述配置后，仍可能失败，常见盲区：
-
APP_ENV=dev时 Symfony 会绕过部分信任逻辑，务必用APP_ENV=prod测试真实行为 - 清除缓存：
php bin/console cache:clear --env=prod，否则旧的 Request 对象可能缓存错误 scheme - Caddyfile 修改后要重载：
sudo caddy reload或重启frankenphp进程，别只改文件不生效 - 如果你在
public/index.php里手动调用Request::setTrustedProxies()，优先删掉——它和 YAML 配置冲突，且 FrankenPHP 下可能被覆盖 - HTTP/3 下某些客户端（如 curl）不带
X-Forwarded-*头，但 Caddy 仍会发，所以重点看服务端日志里的$_SERVER数组，确认头已送达
最简验证法：访问 https://yoursite.com/_profiler，点开任意请求，看「Request Information」里的 Scheme 是否为 https —— 这个准，比前端跳转更底层。
