Symfony2：在控制器中加载所有路由（无需重建缓存）

嘿，我完全懂你这个困扰！每次加载表单都调用Router#getRouteCollection()确实会触发路由缓存的重建，这在生产环境简直是性能灾难——毕竟Symfony的路由缓存就是为了避免每次请求都解析所有路由文件的。给你几个靠谱的方案来解决这个问题：

核心思路：预缓存可用路由，避免请求时动态解析 #

我们的目标是不在请求周期内加载整个路由集合，而是提前收集好需要的路由并缓存起来，表单直接从缓存里拿数据。

1. 创建命令预缓存有效路由 #

先写一个控制台命令，专门用来收集并缓存我们需要的路由（排除掉Symfony自带的调试路由、内部路由等）。这个命令可以在部署时、路由更新后手动执行，或者加到CI/CD流程里。

// src/Command/CacheRoutesCommand.php
namespace App\Command;

use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;
use Symfony\Component\Routing\RouterInterface;
use Symfony\Contracts\Cache\CacheInterface;
use Symfony\Contracts\Cache\ItemInterface;

class CacheRoutesCommand extends Command
{
    protected static $defaultName = 'app:routes:cache';

    public function __construct(
        private RouterInterface $router,
        private CacheInterface $appCache
    ) {
        parent::__construct();
    }

    protected function configure()
    {
        $this->setDescription('预缓存模块可用的路由列表');
    }

    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $routeCollection = $this->router->getRouteCollection();
        $validRoutes = [];

        foreach ($routeCollection->all() as $name => $route) {
            // 排除调试、内部路由（比如_profiler、_wdt开头的）
            if (str_starts_with($name, '_') || str_contains($name, 'profiler')) {
                continue;
            }
            // 可选：只包含标记了"module_available"的路由（需要在路由定义里加defaults）
            if ($route->getDefault('module_available') !== true) {
                continue;
            }
            // 整理成「路径(路由名)」的格式给表单用
            $validRoutes[$name] = sprintf('%s (%s)', $route->getPath(), $name);
        }

        // 把路由列表存入缓存，有效期设为1天（可按需调整）
        $this->appCache->set('module_routes', function(ItemInterface $item) use ($validRoutes) {
            $item->expiresAfter(86400);
            return $validRoutes;
        });

        $output->writeln(sprintf('已缓存 %d 条有效路由', count($validRoutes)));

        return Command::SUCCESS;
    }
}

2. 封装路由获取服务 #

创建一个简单的服务，专门负责从缓存里读取预存的路由列表，这样表单就不用直接和缓存组件交互了：

// src/Service/RouteProvider.php
namespace App\Service;

use Symfony\Contracts\Cache\CacheInterface;

class RouteProvider
{
    public function __construct(private CacheInterface $appCache)
    {
    }

    public function getModuleRoutes(): array
    {
        // 从缓存获取路由，缓存不存在时返回空数组（确保生产环境不会意外触发路由解析）
        return $this->appCache->get('module_routes', function() {
            return [];
        });
    }
}

3. 在表单中使用缓存的路由 #

把RouteProvider注入表单类型，直接用它提供的路由数据构建ChoiceType字段：

// src/Form/ModuleType.php
namespace App\Form;

use App\Entity\Module;
use App\Service\RouteProvider;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class ModuleType extends AbstractType
{
    public function __construct(private RouteProvider $routeProvider)
    {
    }

    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            // 添加你的其他字段...
            ->add('routes', ChoiceType::class, [
                'label' => '关联路由',
                'choices' => $this->routeProvider->getModuleRoutes(),
                'multiple' => true, // 支持多选，根据你的需求调整
                'expanded' => false, // 下拉框样式，改成true就是复选框
                'placeholder' => '请选择要关联的路由',
            ]);
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => Module::class,
        ]);
    }
}

额外优化建议 #

• 路由标记过滤：在需要关联模块的路由定义里，添加defaults: { module_available: true }，这样命令就能精准筛选出允许的路由，避免把所有路由都列出来。
• 开发环境适配：如果想在开发环境实时获取最新路由，可以在RouteProvider里判断环境，开发环境直接调用Router#getRouteCollection()（但记得只在开发环境这么做！）。
• 缓存更新触发：可以在路由文件修改时自动触发缓存命令，比如用Symfony的FileSystemWatcher监听路由目录，不过这个属于进阶操作，按需配置即可。

执行命令更新缓存的方式：

php bin/console app:routes:cache

内容的提问来源于stack exchange，提问作者Cas