Symfony子域名识别需DNS泛解析+Web服务器透传Host头+路由动态匹配三者协同：先配DNS的*记录指向服务器IP，再确保Nginx/Apache正确传递Host头，最后在路由中用host属性与正则requirements匹配子域，并配置trusted_hosts等安全项。
Symfony 本身不参与 DNS 解析，所谓“Symfony 命令域名解析”实际是指在 Symfony 应用中识别、匹配并响应不同子域名或泛域名请求的完整链路配置。它依赖 DNS 层的泛解析 + Web 服务器的主机名透传 + Symfony 路由层的动态主机匹配三者协同，而非靠命令行工具完成解析。
第一步：DNS 层配置泛域名记录
这是整个流程的前提。没有正确的 DNS 解析，请求根本到不了你的 Symfony 应用。
- 登录域名服务商（如阿里云、Cloudflare），进入 DNS 管理页
- 添加一条 A 记录 或 CNAME 记录：
-
主机记录：填写
*（星号） - 记录类型：A（指向服务器 IP）或 CNAME（指向主域名/CDN）
-
记录值：你的服务器公网 IP，或主域名如
example.com - TTL：建议设为 300 秒，便于后续调试生效快
-
主机记录：填写
- 验证是否生效：终端运行
dig test123.example.com +short，应返回你配置的 IP
第二步：Web 服务器透传 Host 头（关键！）
Symfony 需要从请求中拿到原始 Host（如 admin.example.com 或 user123.example.com），否则路由无法按主机名匹配。务必确认 Nginx/Apache 没有重写或丢弃 Host 头。
-
Nginx 示例（确保
server_name包含通配模式）：server { listen 80; server_name example.com www.example.com ~^([^.]+)\.example\.com$; root /var/www/symfony/public; # … 其他标准配置 } -
Apache 示例（启用
UseCanonicalName Off并允许 ServerAlias 通配）：<VirtualHost *:80> ServerName example.com ServerAlias *.example.com DocumentRoot /var/www/symfony/public UseCanonicalName Off </VirtualHost> - 重启服务后，可通过
curl -H "Host: demo.example.com" http://your-server-ip测试是否能正确传递 Host
第三步：Symfony 路由支持动态主机匹配
使用 host 属性 + 正则 requirements，让同一个路由响应多个合法子域名，同时保留 URL 生成能力。
- 在
.env中定义匹配规则（例如只接受特定前缀的子域）：APP_PUBLIC_HOSTNAMES_PATTERN=^(admin|api|shop|[^.]{3,})\.example\.com$ - 控制器路由示例：
#[Route( path: '/', host: '{domain}', requirements: ['domain' => '%env(APP_PUBLIC_HOSTNAMES_PATTERN)%'], name: 'app_home_by_domain' )] - 在控制器中可直接获取子域名：
public function index(Request $request): Response { $host = $request->getHost(); // 如 shop.example.com $subdomain = explode('.', $host)[0]; // 如 shop // 后续可据此加载租户配置、切换模板等 } - URL 生成时自动复用当前 Host：
$this->generateUrl('app_home_by_domain')会输出https://shop.example.com/（前提是启用了 HTTPS 和 trusted_hosts）
第四步：安全与生产加固要点
泛域名开放性强，但风险也高，必须同步加固：
-
配置 trusted_hosts：在
config/packages/framework.yaml中明确允许的域名模式：framework: trusted_hosts: ['^example\.com$', '^.*\.example\.com$'] -
强制 HTTPS + HSTS：避免 Host 头被篡改或降级：
framework: session: cookie_secure: true cookie_samesite: lax # 并在 Nginx/Apache 中重定向 HTTP → HTTPS -
禁用未授权子域访问：对不匹配
APP_PUBLIC_HOSTNAMES_PATTERN的 Host，返回 400 或重定向到主站，防止恶意子域探测 -
SSL 证书需支持泛域名：申请
*.example.com类型证书（如 Let’s Encrypt 的 wildcard cert），并确保自动续期脚本覆盖所有子域场景
