Symfony命令域名解析：子域名与泛域名绑定的实战教程【教程】-php教程-PHP中文网

symfony子域名识别需dns泛解析+web服务器透传host头+路由动态匹配三者协同：先配dns的*记录指向服务器ip，再确保nginx/apache正确传递host头，最后在路由中用host属性与正则requirements匹配子域，并配置trusted_hosts等安全项。

symfony命令域名解析：子域名与泛域名绑定的实战教程【教程】

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 头。

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

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>
    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），并确保自动续期脚本覆盖所有子域场景