Установка

Контракты предоставляются как отдельные пакеты, поэтому вы можете установить только те проекты, которые вам действительно нужны:

1
2
3
4
5
6

$ composer require symfony/cache-contracts
$ composer require symfony/event-dispatcher-contracts
$ composer require symfony/deprecation-contracts
$ composer require symfony/http-client-contracts
$ composer require symfony/service-contracts
$ composer require symfony/translation-contracts

Использование

Абстрации к вэтом пакете полезны для слабой связанности и взаимосовместимости. Используя предоставленный интерфейс в качестве подсказок, вы можете повторно использовать любые реализации, соответствующие контрактам. Это может быть компонент Symfony или другой пакет, предоставленный PHP-сообществом в целом.

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

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

Принципы разработки

• Контракты разделяются по доменам, каждый в собственное под-пространство имен;
• Контракты - это маленькие и согласованные наборы PHP-интерфейсов, трейтов, нормативных are small and consistent sets of PHP interfaces, traits, normative docblock и наборов тестов для примера, где это возможно ...;
• Контракты должны иметь доказанную реализацию для того, чтобы попасть в хранилище;
• Контракты должны быть обратно совместимы с существующими компонентами Symfony.

Пакеты, реализующие конкретные контракты, должны перечислять их в разделе provide файла composer.json, используя соглашение symfony/*-implementation. Например:

1
2
3
4
5
6

{
    "...": "...",
    "provide": {
        "symfony/cache-implementation": "1.0"
    }
}

Часто задаваемые вопросы