Symfony 2.8.52 Bundle 遵循清晰分层结构：Controller/、Entity/、Repository/、Form/、Resources/（含views/config/translations/public）、Tests/为必需目录；服务与路由应按功能拆分配置文件；须避免硬编码、直连EM、复制第三方库等反模式。
Symfony 2.8.52 虽已停止官方维护（2024年11月起不再接收安全更新），但仍有存量项目在运行。其 Bundle 目录结构虽不如现代 Symfony 4+/6+ 的扁平化目录直观，但遵循一套成熟、可扩展的约定。关键不是“最简”，而是“清晰分层、职责分明、便于测试与复用”。
Bundle 根目录必须包含的标准子目录
每个 Bundle（如 AcmeStoreBundle）应至少包含以下结构：
-
Controller/：只放控制器类，命名以
Controller结尾（如ProductController.php）。不建议在此处理业务逻辑。 -
Entity/：Doctrine 实体类，对应数据库表。若使用 YAML 或 XML 映射，配置文件放在
Resources/config/doctrine/下。 -
Repository/：自定义仓储类，继承
EntityRepository，封装复杂查询。 -
Form/：表单类型类（
ProductType.php），与实体解耦，支持重用和测试。 -
Resources/：存放非 PHP 资源：
-
views/：Twig 模板，按控制器分组（如Product/index.html.twig）； -
config/：Bundle 自身的配置（services.yml、routing.yml）； -
translations/：XLIFF 或 YAML 格式的翻译文件（如messages.fr.xlf）； -
public/：Bundle 级静态资源（CSS/JS/图片），会被assets:install复制到web/。
-
-
Tests/：对应源码的测试类（
Controller/、Entity/等子目录结构保持一致），方便按层级运行测试。
服务与配置的组织方式
Bundle 不应把所有服务塞进一个 services.yml。推荐按功能拆分：
-
Resources/config/services.yml：主入口，仅导入其他文件； -
Resources/config/services/controller.yml：控制器相关服务（如事件监听器）； -
Resources/config/services/repository.yml：仓储服务定义； -
Resources/config/services/form.yml：表单类型注册（需form.type标签）。
路由也同理：Resources/config/routing.yml 应只做导入，实际规则放在 routing/product.yml、routing/user.yml 中，避免单文件臃肿。
避免常见反模式
这些做法会降低可维护性，尤其在团队协作中：
- 不在
Controller/中直接 new Entity 或调用 Doctrine EntityManager；应通过服务或仓储获取； - 不把 Twig 模板逻辑写进
Controller；模板中用include或render(controller())复用片段； - 不把翻译键硬编码在模板里（如
{{ 'product.title'|trans }}），而应在Controller或服务中统一处理动态参数； - 不将第三方库代码复制进
Vendor/或 Bundle 内；一律通过 Composer 管理依赖。
兼容性与升级提示
2.8.52 使用的是旧式 Bundle 结构（bundle-name-bundle 命名），升级到 Symfony 4+ 时需重构为基于目录的结构（src/ 下无 Bundle 嵌套）。若暂不升级，务必确保：
-
AppKernel.php中 Bundle 注册顺序正确（依赖前置）； - 所有
Resources/config文件使用 YAML 格式（2.8 不原生支持 PHP 配置）； - 翻译文件必须放在
Resources/translations/，且文件名格式为domain.locale.format（如messages.en.yml）； - 运行
php app/console translation:extract en --dir=src/Acme/StoreBundle可自动扫描 PHP 和 Twig 中的trans调用。
