Обновление стороннего пакета для старшей версии Symfony¶

Разрешение на установку компонентов Symfony 3¶

БОльшинство сторонних пакетов определяют свои зависимости Symfony, используя ограничения ~2.N или ^2.N в файле composer.json. Например:

1
2
3
4
5
6
7

{
    "require": {
        "symfony/framework-bundle": "~2.7",
        "symfony/finder": "~2.7",
        "symfony/validator": "~2.7"
    }
}

Эти ограничения предотвращают использование пакетом компонентов Symfony 3, так что становится невозможно установить его в приложение, основанное на Symfony 3. Эту проблему очень легко решить благодаря гибкости ограничений зависимости Композера (Composer). Просто замените ~2.N на ~2.N|~3.0 (или ^2.N на ^2.N|~3.0).

Вышеописанные пример можно обновить так, чтобы он работал с Symfony 3 следующим образом:

1
2
3
4
5
6
7

{
    "require": {
        "symfony/framework-bundle": "~2.7|~3.0",
        "symfony/finder": "~2.7|~3.0",
        "symfony/validator": "~2.7|~3.0"
    }
}

Ищите возражения и исправляйте их¶

Кроме того, чтоб позволить пользователям испгользовать ваш пакет в Symfony 3, ваш пакет должен перестать использовать любые функции, осуждённые в версии 2.8, потому что в версии 3.0 они были удалены (вы будете получать исключени или PHP-ошибки). Наиболее лёгким способом определить возражения является установка symfony/phpunit-bridge package и последующий запуск набора тестов.

Для начала, установите компонент в качестве зависимости dev вашего пакета:

1

$ composer require --dev symfony/phpunit-bridge

Потом, запустите ваш набор тестов и ищите перечень возражений, отображённый после отчета о тестировании PHPUnit:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

$ phpunit

# ... PHPUnit output

Оставшиеся уведомления о возраженияж (3)

Опция "шаблон" (pattern) в файле ... осуждается с версии 2.2 и будет удалена в версии
3.0. Используйте опцию "путь" (path) в определении маршрута вместо этого ...

Функция Twig "form_enctype" осуждается. Вместо неё используйте "form_start" в ...

Класс Symfony\Component\Security\Core\SecurityContext осуждается с вресии 2.6 и будет
удалён в версии 3.0. Используйте ...

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

Тестирование вашего пакет в Symfony 3¶

Теперь, когда ваш пакет был избавлен от всех возражений, пора тестировать его по-настоящему в приложении Symfony 3. Если предположить, что у вас уже есть приложение Symfony 3, то вы можете протестировать обновлённый пакет, без необходимости его установки через Composer.

Если ваша операционная система поддерживает символические ссылки, просто направьте необходимый каталог-поставщик к вашему локальному корневому каталогу пакета:

1

$ ln -s /path/to/your/local/bundle/ vendor/you-vendor-name/your-bundle-name

Если ваша операционная система не поддерживает символьные ссылки, вам понадобится скопироваь ваш локальный каталог пакета в соответствующий каталог внутри vendor/.

 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
26
27
28
29
30

language: php
sudo: false
php:
    - 5.3
    - 5.6
    - 7.0

matrix:
    include:
        - php: 5.3.3
          env: COMPOSER_FLAGS='--prefer-lowest --prefer-stable' SYMFONY_DEPRECATIONS_HELPER=weak
        - php: 5.6
          env: SYMFONY_VERSION='2.7.*'
        - php: 5.6
          env: SYMFONY_VERSION='2.8.*'
        - php: 5.6
          env: SYMFONY_VERSION='3.0.*'
        - php: 5.6
          env: SYMFONY_VERSION='3.1.*'
        - php: 5.6
          env: DEPENDENCIES='dev' SYMFONY_VERSION='3.2.*@dev'

before_install:
    - composer self-update
    - if [ "$DEPENDENCIES" == "dev" ]; then perl -pi -e 's/^}$/,"minimum-stability":"dev"}/' composer.json; fi;
    - if [ "$SYMFONY_VERSION" != "" ]; then composer --no-update require symfony/symfony:${SYMFONY_VERSION}; fi;

install: composer update $COMPOSER_FLAGS

script: phpunit

Обновление вашего кода для поддержки Symfony 2.x и 3.x одновременно¶

Настоящей сложностью добавления поддержки Symfony 3 в ваши пакеты является ситуация, когда вы хотите, чтобы пакет поддерживал обе версии Symfony 2.x и 3.x одновременно, используя один код. Есть несколько острых углов, где вам понадобится расправиться с различиями API.

Перед тем, как углубляться в специфику наиболее распространённых крайних случаев, общей рекомендацией является не пологаться на версию Symfony Kernel, чтобы решить, какой код использовать:

if (Kernel::VERSION_ID < 20800) {
    // код для Symfony 2.x
} else {
    // код для Symfony 3.x
}

Вместо того, чтобы проверять версию Symfony Kernel, проверьте версию конкретного компонента. Например, OptionsResolver API изменился в версии 2.6, путём добавления метода setDefined(). Рекомендуемой проверкой в этом случае будет:

use Symfony\Component\OptionsResolver\OptionsResolver;

if (!method_exists(OptionsResolver::class, 'setDefined')) {
    // код для старого OptionsResolver API
} else {
    // код для нового OptionsResolver API
}