Установка

Контракти постачаютьяс як окремі пакети, тому ви можете встановити лише ті проекти, які вам дійсно потрібні:

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-інтерфейсів, трейтів, нормативних docblock та наборів тестів для прикладу, де це можливо ...;
• Контракти повинні мати доведену реалізацію для того, щоб потрапити у сховище;
• Контракти повинні бути зворотно сумісними з існуючими компонентами Symfony.

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

1
2
3
4
5
6

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

Часто поставлені питання