如何覆盖 Bundle 的任何部分

模板

第三方 bundle 模板可以在 <your-project>/templates/bundles/<bundle-name>/ 目录中被覆盖。新的模板必须使用与原始模板相同的名称和路径（相对于 <bundle>/templates/）。

例如，要覆盖来自 AcmeUserBundle 的 templates/registration/confirmed.html.twig 模板，请创建此模板：<your-project>/templates/bundles/AcmeUserBundle/registration/confirmed.html.twig

除了覆盖整个模板，你可能只想覆盖一个或多个块。然而，由于你正在覆盖你想要扩展的模板，你最终会陷入无限循环错误。解决方案是在模板名称中使用特殊的 ! 前缀，以告诉 Symfony 你想要从原始模板扩展，而不是从被覆盖的模板扩展。

1
2
3
4
5
6
7

{# templates/bundles/AcmeUserBundle/registration/confirmed.html.twig #}
{# the special '!' prefix avoids errors when extending from an overridden template #}
{% extends "@!AcmeUser/registration/confirmed.html.twig" %}

{% block some_block %}
    ...
{% endblock %}

路由

路由永远不会在 Symfony 中自动导入。如果你想包含来自任何 bundle 的路由，那么它们必须从你的应用程序中的某个位置手动导入（例如 config/routes.yaml）。

“覆盖” bundle 路由的最简单方法是完全不导入它。与其导入第三方 bundle 的路由，不如将该路由文件复制到你的应用程序中，修改它，然后导入它。

控制器

如果控制器是一个服务，请参阅下一节关于如何覆盖它。否则，定义一个新的路由 + 控制器，其路径与你想要覆盖的控制器关联（并确保新的路由在 bundle 路由之前加载）。

服务 & 配置

如果你想修改 bundle 创建的服务，你可以使用服务装饰。

如果你想进行更高级的操作，例如删除其他 bundle 创建的服务，你必须在编译器 pass中使用服务定义。

实体 & 实体映射

只有当 bundle 提供映射的父类（例如 FOSUserBundle 中的 User 实体）时，覆盖实体映射才有可能。可以通过这种方式覆盖属性和关联。在Doctrine 文档中了解更多关于此功能及其限制的信息。

表单

现有的表单类型可以通过定义表单类型扩展来修改。

验证元数据

Symfony 从每个 bundle 加载所有验证配置文件，并将它们组合成一个验证元数据树。这意味着你可以向属性添加新的约束，但你不能覆盖它们。

为了克服这个问题，第三方 bundle 需要为验证组进行配置。例如，FOSUserBundle 就有这个配置。要创建你自己的验证，请将约束添加到新的验证组

1
2
3
4
5
6
7
8
9
10

# config/validator/validation.yaml
FOS\UserBundle\Model\User:
    properties:
        plainPassword:
            - NotBlank:
                groups: [AcmeValidation]
            - Length:
                min: 6
                minMessage: fos_user.password.short
                groups: [AcmeValidation]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

<!-- config/validator/validation.xml -->
<?xml version="1.0" encoding="UTF-8" ?>
<constraint-mapping xmlns="https://symfony.ac.cn/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="https://symfony.ac.cn/schema/dic/constraint-mapping
        https://symfony.ac.cn/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd"
>
    <class name="FOS\UserBundle\Model\User">
        <property name="plainPassword">
            <constraint name="NotBlank">
                <option name="groups">
                    <value>AcmeValidation</value>
                </option>
            </constraint>

            <constraint name="Length">
                <option name="min">6</option>
                <option name="minMessage">fos_user.password.short</option>
                <option name="groups">
                    <value>AcmeValidation</value>
                </option>
            </constraint>
        </property>
    </class>
</constraint-mapping>

现在，更新 FOSUserBundle 配置，使其使用你的验证组而不是原始的验证组。

翻译

翻译与 bundle 无关，而是与翻译域有关。因此，你可以从主 translations/ 目录覆盖任何 bundle 翻译文件，只要新文件使用相同的域。

例如，要覆盖在 AcmeUserBundle 的 translations/AcmeUserBundle.es.yaml 文件中定义的翻译，请创建一个 <your-project>/translations/AcmeUserBundle.es.yaml 文件。