Symfony 3.4多Bundle迁移至4.0 AppBundle实操指南求助

一、目录迁移与命名空间调整 #

• 把各Bundle下的Controller、Entity、Repository等目录，按功能归类移到src/下（比如原LogBundle/Controller移到src/Controller/Log/，避免重名控制器冲突）
• 全局修改类命名空间：原App\LogBundle\Controller\DefaultController改为App\Controller\Log\DefaultController，替换时注意精准匹配，别误改其他内容
• 删除所有*Bundle.php类文件（如LogBundle.php），同时移除config/bundles.php里对应的Bundle注册项

二、重名控制器冲突解决 #

• 给重名的DefaultController加功能前缀，比如原FinanceBundle下的改为FinanceDefaultController，或者放到功能子目录（如src/Controller/Finance/DefaultController.php）
• 确保每个控制器类名唯一，同步更新路由配置里的控制器引用

三、路由配置修复 #

• 把原Bundle路由文件（如LogBundle/Resources/config/routing.yml）移到config/routes/下，重命名为log.yaml
• 修改路由里的控制器引用格式：原LogBundle:Default:index改为App\Controller\Log\DefaultController::indexAction（Symfony 4.x推荐用完全限定类名+方法名）
• 移除路由中的Bundle路径引用，比如把resource: "@LogBundle/Resources/config/routing.yml"改为resource: "../config/routes/log.yaml"
• 检查config/routes.yaml的导入规则，确保所有子路由都正确导入

四、模板路径修复 #

• 原Bundle模板（如LogBundle/Resources/views/Default/index.html.twig）移到templates/下，按功能归类为templates/log/default/index.html.twig
• 修改控制器渲染代码：原return $this->render('@Log/Default/index.html.twig')改为return $this->render('log/default/index.html.twig')
• 全局替换模板里的@BundleName引用为对应功能目录名，同时检查模板继承、包含的路径是否同步修改

五、实体关联与ORM配置修复 #

• 实体类移到src/Entity/下，按功能子目录存放（如src/Entity/Log/OperationLog.php），更新命名空间
• 修改实体关联注解：原@ORM\ManyToOne(targetEntity="App\UserBundle\Entity\User")改为@ORM\ManyToOne(targetEntity="App\Entity\User\User")（根据实体实际存放路径调整）
• 原Bundle的ORM配置文件（如LogBundle/Resources/config/doctrine/OperationLog.orm.yml）移到config/doctrine/下，更新实体类的命名空间引用
• 执行php bin/console doctrine:schema:validate验证映射是否正确，修复关联错误

六、其他配置收尾 #

• 检查services.yaml，删除Bundle相关的服务配置，Symfony 4.x默认支持App\命名空间的自动注册
• 更新composer.json的自动加载配置，确保src/目录映射正确：

  "autoload": {
      "psr-4": {
          "App\\": "src/"
      }
  }
  

• 执行composer dump-autoload更新自动加载映射，再清理缓存：php bin/console cache:clear

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