两个项目共用相同实体，如何高效维护代码？

这确实是Symfony 3.4多项目共享实体时非常头疼的问题，尤其是依赖Bundle架构的情况下，手动同步实体的修改简直是噩梦。我之前在维护类似架构的项目时试过几个方案，分享给你参考：

方案1：抽离共享实体为独立Composer包（最推荐的长期方案） #

把两个项目共用的Entities单独剥离出来，做成一个独立的Composer包，托管到你的私有Git仓库（比如GitLab、GitHub私有库都可以）。然后API和前端项目都通过Composer来引入这个包，这样所有共享实体的修改只需要在这个独立包中完成，两个主项目只需要执行composer update your/shared-entity-package就能同步最新的实体代码。

具体操作细节：

• 这个包不需要是完整的Symfony Bundle，只需要包含Entities类、对应的Doctrine映射配置（注解、XML或YAML都可以），以及必要的依赖（比如doctrine/orm、symfony/orm-pack这类基础依赖）。
• 在API和前端项目的composer.json中，添加私有仓库的配置指向你的实体包Git地址，比如：

  "repositories": [
      {
          "type": "git",
          "url": "git@your-git-host:your-team/shared-entities.git"
      }
  ]
  

• 前端项目自己的额外Entities依然放在项目内部的Bundle中，和共享实体互不干扰，各司其职。

方案2：使用Git子模块（快速过渡方案） #

如果暂时不想折腾Composer包，可以把共享实体所在的目录做成Git子模块，分别添加到API和前端项目的Git仓库中。这样两个项目都引用同一个子模块的代码，修改子模块后，在两个主项目里执行git submodule update --remote就能同步最新的实体修改。

需要注意的点：

• 规划好子模块在项目中的路径，比如统一放在src/SharedEntityBundle，确保两个项目的Autoloader能正确加载这些实体类。
• 团队成员需要熟悉Git子模块的基本操作，避免出现子模块版本不一致的问题（比如忘记更新子模块导致某个项目用了旧的实体代码）。

方案3：符号链接（本地开发临时方案，生产环境禁用） #

如果只是本地开发时想临时解决同步问题，可以在两个项目之间对共享实体目录创建符号链接，这样修改一边的代码，另一边会实时同步。比如在前端项目的终端执行：

ln -s /path/to/your-api-project/src/SharedEntities src/SharedEntities

但这个方案绝对不能用在生产环境，服务器的权限、部署流程都可能导致符号链接失效，而且版本控制也没法很好地管理实体的修改记录。

额外的优化建议 #

• 不管用哪种方案，一定要给共享实体编写单元测试或集成测试，确保修改实体后不会破坏API和前端项目的业务逻辑。
• 针对Symfony 3.4，要在两个项目的config.yml中配置Doctrine的映射，确保共享实体能被正确识别，比如：

  doctrine:
      orm:
          entity_managers:
              default:
                  mappings:
                      SharedEntities:
                          type: annotation
                          dir: '%kernel.project_dir%/src/SharedEntities'
                          prefix: 'App\SharedEntities'
                          alias: SharedEntities
  

• 如果后续有升级Symfony版本的计划，可以考虑逐步过渡到Symfony Flex的目录结构，共享实体的管理会更灵活，也更容易适配现代的Composer包管理方式。

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