Шаблоны

Шаблоны сторонних бандлов могут быть переопределены в каталоге <your-project>/templates/bundles/<bundle-name>/. Новые шаблоны должны использовать то же имя и путь (относительно <bundle>/Resources/views/) как и оригинальные шаблоны.

Например, для переопределения шаблона templates/registration/confirmed.html.twig из AcmeUserBundle, создайте этот шаблон: <your-project>/templates/bundles/AcmeUserBundle/registration/confirmed.html.twig

Вместо переопределения всего шаблона, вы можете хотеть переопределить только один или несколько блоков. Однако, так как вы переопределяете шаблон из которого вы хотите расширять, вы получите бесконечный цикл ошибки. Решением будет использовать специальный префикс ! в имени шаблона, чтобы сообщить Symfony, что вы хотите расширить из исходного шаблона, а не из переопределённого:

1
2
3
4
5
6
7

{# templates/bundles/AcmeUserBundle/registration/confirmed.html.twig #}
{# специальный префикс '!' избегает ошибок при расширении из переопределённого шаблона #}
{% extends "@!AcmeUser/registration/confirmed.html.twig" %}

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

Маршрутизация

Маршрутизация в Symfony никогда не импортируется автоматически. Если вы хотите включить маршруты из любого пакета, то они должны быть импортированы вручную откуда-то из вашего приложения (например, config/routes.yaml).

Самый простой способ "переопределить" маршрутизацию пакета - не импортировать её в принципе. Вместо импортирования маршрутизации стороннего пакета, просто скопируйте файл маршрутизации в ваше приложение, измените его и импортируйте.

Контроллеры

Если контроллер является сервисом, смотрите следующий раздел о том, как пеоепределить его. В обратном случае, определите новый маршрут + контроллер с одним путём, связанным с контроллером, который вы хотите переопределить (и убедитесь, что новый маршрут загружается до маршрута пакета).

Сервисы и конфигурация

Если вы хотите изменить сервисы, созданные пакетом, вы можете использовать декорирование сервисов.

Если вы хотите провести более продвинутые манипуляции, вроде удаления сервисов, созданных другими пакетами, вы должны работать с определениями сервиса внутри передачи компилятора.

Сущности и их отображение

В связи с особенностями работы Doctrine, невозможно переопределить отображение сущностей пакета. Однако, если пакет предоставляет отображённый суперкласс (как, например, сущность User в FOSUserBundle), то можно переопределить атрибуты и ассоциации. Узнайте больше об этой функции и её ограничениях в документации Doctrine.

Формы

Существующие типы форм могут быть изменены путём определения расширений типа формы.

Метаданные валидации

Symfony загружает все файлы конфигурации валидации из каждого пакета и комбинирует их в одно древо метаданных валидации. Это означает, что вы можете добавить новые ограничения к свойству, но не можете переопределить их.

Чтобы обойти это, сторонний пает должен иметь конфигурацию для групп валидации. Например, 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="http://symfony.com/schema/dic/constraint-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
        https://symfony.com/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 так, чтобы он использовал ваши группы валидации вместо исходных.

Переводы

Переводы не связаны с пакетами, но связаны с доменами переводов. For this reason, you can override any bundle translation file from the main translations/ directory, as long as the new file uses the same domain.

Например, для переопределения переводов, определённых в файле translations/AcmeUserBundle.es.yaml из AcmeUserBundle, создайте файл <your-project>/translations/AcmeUserBundle.es.yaml.