如何将Symfony 6控制器迁移至多个自定义功能目录？

问题背景 #

我正在开发一个大型Symfony项目，希望摒弃默认的按类型划分目录（如所有控制器放src/Controller、表单放src/Form）的结构，改为按功能模块组织：每个功能模块单独建目录，比如src/Home下包含首页的控制器和相关逻辑，src/Blog下包含博客的控制器、表单等。但原有的路由配置只扫描src/Controller目录，导致新结构下的路由无法被识别，执行php bin/console debug:router看不到这些路由。

原routes.yaml配置：

controllers:
    resource:
        path: ../src/Controller/
        namespace: App\Controller
    type: attribute

解决方案 #

1. 修改路由配置扫描整个src目录 #

将routes.yaml中的路径改为整个src目录，并把命名空间调整为App（因为功能模块的控制器现在位于App下的子命名空间，比如App\Home）：

controllers:
    resource:
        path: ../src/
        namespace: App
    type: attribute

这样Symfony会扫描src目录下所有带有路由属性（#[Route]）的类，无论它们在哪个子目录中。

2. 确保控制器命名空间正确 #

以首页模块为例，控制器文件src/Home/HomeController.php的命名空间应为：

namespace App\Home;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\Routing\Annotation\Route;

class HomeController extends AbstractController
{
    #[Route('/', name: 'home_index')]
    public function index()
    {
        return $this->render('home/index.html.twig');
    }
}

3. 可选：精准扫描指定功能模块目录 #

如果不想扫描整个src目录（避免扫描非路由类），可以逐个指定功能模块的路径：

controllers:
    resource:
        - { path: ../src/Home/, namespace: App\Home }
        - { path: ../src/Blog/, namespace: App\Blog }
        # 添加其他功能模块的路径
    type: attribute

4. 验证路由生效 #

执行命令验证路由是否被识别：

php bin/console debug:router

补充：模板的功能化组织 #

模板也可以对应功能模块放在templates的子目录中，比如templates/home/index.html.twig、templates/blog/post.html.twig，控制器中直接通过路径引用即可，Twig会自动匹配对应文件。

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