支持 Symfony 路由中的多个动态主机-php教程-PHP中文网

支持 Symfony 路由中的多个动态主机

心靈之曲

发布： 2025-10-13 10:28:51

原创

681人浏览过

支持 Symfony 路由中的多个动态主机

zuojiankuohaophpcnp>本文档介绍如何在 Symfony 框架中支持多个动态主机，并根据不同的域名将请求路由到不同的应用程序上下文。通过配置路由规则和自定义 RequestListener，可以实现基于域名的应用程序上下文切换，从而满足多品牌或多域名应用的需求。</p> 在 Symfony 应用中，支持多个动态主机，并将请求路由到不同的应用程序上下文（例如，不同的防火墙和控制器）是一个常见的需求。本文将探讨如何使用 Symfony 路由实现这一目标，并提供一种基于 RequestListener 的解决方案。 ### 问题背景假设我们需要支持以下场景：

main-domain.tld -> main_context main-domain2.tld -> main_context service.main-domain.tld -> service_context service.main-domain2.tld -> service_context service.maybe-several-other-brand-domains.tld -> service_context admin.main-domain.tld -> admin_context admin.main-domain2.tld -> admin_context admin.maybe-several-other-brand-domains.tld -> admin_context

在只有一个域名的情况下，我们可以使用以下方式将控制器分配给特定的上下文：

```php
#[Route(
    path: '/',
    requirements: ['domain' => '%app.public_hostname_context1%'],
    defaults: ['domain' => '%app.public_hostname_context1%'],
    host: '{domain}',
)]

登录后复制

其中 app.public_hostname_context1 是在 .env.local 文件中配置的主机名。

当需要支持多个域名时，defaults 配置无法访问当前主机名，因此需要在生成 URL 时显式设置域名。

解决方案：使用 RequestListener 设置默认域名

一种解决方案是移除路由定义中的 defaults，并为每个上下文的有效域名提供一个模式。

#[Route(
    path: '/',
    requirements: ['domain' => '%app.public_hostnames_context1_pattern%'],
    host: '{domain}',
)]

登录后复制

app.public_hostnames_context1_pattern 是在 .env.local 文件中配置的模式，包含该上下文的所有可能主机名，例如：

PUBLIC_HOSTNAME_CONTEXT1_PATTERN=(?:service\.main-domain\.tld|service\.main-domain2\.tld)

登录后复制

为了为所有路由的 domain 参数设置当前主机名作为默认值，我们可以创建一个 RequestListener，并在 RouterListener 之前执行它。

1. 配置 services.yaml:

services:
    # 必须在 RouterListener (优先级 32) 之前调用，以加载域名
    App\EventListener\RequestListener:
        tags:
            - { name: kernel.event_listener, event: kernel.request, priority: 33 }

登录后复制

2. 创建 RequestListener:

飞书多维表格

表格形态的AI工作流搭建工具，支持批量化的AI创作与分析任务，接入DeepSeek R1满血版

查看详情

<?php
declare(strict_types=1);
namespace App\EventListener;

use Symfony\Component\HttpKernel\Event\RequestEvent;
use Symfony\Component\Routing\RouterInterface;

class RequestListener
{
    public function __construct(
        private RouterInterface $router,
    ){}

    public function onKernelRequest(RequestEvent $event)
    {
        if (false === $this->router->getContext()->hasParameter('domain')) {
            $this->router->getContext()->setParameter('domain', $event->getRequest()->getHost());
        }
    }
}

登录后复制

这段代码的作用是，如果路由上下文中没有 domain 参数，则将当前请求的主机名设置为 domain 参数的值。