无需路由加载器，在Symfony启动后路由使用前添加自定义路由

针对静态路由需随环境变更URL的问题，以下是几种可行的实现方式：

方法一：利用环境变量直接配置路由（最简方案） #

Symfony原生支持在路由配置中使用环境变量，可直接在不同环境的配置文件中定义路由路径，无需额外代码：

1. 在路由配置文件中引入环境变量：

# config/routes.yaml
app_home:
    path: '%env(APP_ROUTE_HOME_PATH)%'
    controller: App\Controller\HomeController::index

app_dashboard:
    path: '%env(APP_ROUTE_DASHBOARD_PATH)%'
    controller: App\Controller\DashboardController::index

2. 在对应环境的.env文件中设置变量值：

# .env.local（开发环境）
APP_ROUTE_HOME_PATH=/dev/home
APP_ROUTE_DASHBOARD_PATH=/dev/dashboard

# .env.prod（生产环境）
APP_ROUTE_HOME_PATH=/prod/home
APP_ROUTE_DASHBOARD_PATH=/prod/dashboard

Symfony会在加载路由时自动替换环境变量，且路由缓存会按环境隔离，不同环境的缓存不会互相干扰。

方法二：自定义路由加载器（复杂逻辑场景） #

如果需要根据环境执行更复杂的路由生成逻辑（比如动态添加路由前缀、加载不同路由文件），可以实现自定义路由加载器：

1. 创建自定义路由加载器类：

// src/Routing/EnvironmentRouteLoader.php
namespace App\Routing;

use Symfony\Component\Config\Loader\Loader;
use Symfony\Component\Routing\Route;
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\HttpKernel\KernelInterface;

class EnvironmentRouteLoader extends Loader
{
    private $kernel;
    private $loaded = false;

    public function __construct(KernelInterface $kernel)
    {
        $this->kernel = $kernel;
    }

    public function load($resource, $type = null)
    {
        if ($this->loaded) {
            throw new \RuntimeException('该加载器仅允许加载一次');
        }

        $routes = new RouteCollection();
        $env = $this->kernel->getEnvironment();

        // 根据环境动态生成路由路径
        $homePath = match($env) {
            'dev' => '/dev/home',
            'prod' => '/prod/home',
            default => '/home',
        };
        $homeRoute = new Route($homePath, [
            '_controller' => 'App\Controller\HomeController::index'
        ]);
        $routes->add('app_home', $homeRoute);

        // 导入静态路由文件
        $staticRoutes = $this->import('../config/routes/static_routes.yaml', 'yaml');
        $routes->addCollection($staticRoutes);

        $this->loaded = true;
        return $routes;
    }

    public function supports($resource, $type = null)
    {
        return $type === 'environment_routes';
    }
}

2. 在服务配置中注册加载器：

# config/services.yaml
services:
    App\Routing\EnvironmentRouteLoader:
        tags:
            - { name: routing.loader }

3. 在路由配置中引入自定义加载器：

# config/routes.yaml
environment_routes:
    resource: .
    type: environment_routes

方法三：通过CompilerPass动态修改路由集合 #

如果需要对已加载的所有路由统一调整（比如批量添加环境前缀），可以使用容器编译阶段的CompilerPass：

1. 创建CompilerPass类：

// src/DependencyInjection/Compiler/EnvironmentRouteCompilerPass.php
namespace App\DependencyInjection\Compiler;

use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
use Symfony\Component\DependencyInjection\ContainerBuilder;
use Symfony\Component\Routing\RouteCollection;

class EnvironmentRouteCompilerPass implements CompilerPassInterface
{
    public function process(ContainerBuilder $container)
    {
        if (!$container->hasDefinition('router')) {
            return;
        }

        $routerDef = $container->getDefinition('router');
        $env = $container->getParameter('kernel.environment');
        /** @var RouteCollection $routeCollection */
        $routeCollection = $routerDef->getArgument(1);

        // 为所有路由添加环境前缀
        $prefix = match($env) {
            'dev' => '/dev',
            'prod' => '/prod',
            default => '',
        };

        foreach ($routeCollection->all() as $route) {
            $route->setPath($prefix . $route->getPath());
        }
    }
}

2. 在Kernel类中注册CompilerPass：

// src/Kernel.php
namespace App;

use App\DependencyInjection\Compiler\EnvironmentRouteCompilerPass;
use Symfony\Component\DependencyInjection\ContainerBuilder;
use Symfony\Component\HttpKernel\Kernel as BaseKernel;

class Kernel extends BaseKernel
{
    // ...

    protected function build(ContainerBuilder $container)
    {
        parent::build($container);
        $container->addCompilerPass(new EnvironmentRouteCompilerPass());
    }
}

内容的提问来源于stack exchange，提问作者P.K.