В любом большом проекте, где используется composer, рано или поздно возникает одна проблема. Во фреймворке, или в каком-то его отдельном пакете исправляют ошибку или добавляют функциональность, а разработчик не спешит принимать pull request. При этом хочется временно использовать обновленный пакет, а потом, когда pull request все-таки примут, вернуться к официальной версии. Ситуация также осложняется тем, что пакет может быть указан в зависимостях других пакетов.

Я сам столкнулся с этой проблемой: в yii/yii2-elasticsearch нет поддержки scroll API, а она мне нужна. При этом соответствующий pull request висит с октября 2015 года. Естественно, я задался вопросом: как бы поудобнее временно подключить к своему проекту версию пакета, где реализована нужная функциональность? При этом я понимаю, что рано или поздно этот pull request все-таки примут, и придется переключаться обратно.

UPDATE: Как оказалось, все уже решено и подробно описано в документации.

1. Сделать fork нужной версии пакета. В моем случае, я ответвился от 13leaf/yii2-elasticsearch. Появился пакет beowulfenator/yii2-elasticsearch. В пакете создать новую ветку, например, bugfix.

2. В composer.json проекта поменять версию пакета. К названию ветки добавить dev-:

"yiisoft/yii2-elasticsearch":"dev-bugfix"

3. Указать в composer.json проекта ссылку на репозиторий:

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/beowulfenator/yii2-elasticsearch.git"
    }
]

После этого достаточно выполнить composer update, и теперь вместо официального пакета будет использоваться наш собственный.
Важно, чтобы в нашем экземпляре пакета в файле composer.json в поле name было указано «yiisoft/yii2-elasticsearch». Поскольку репозитории, указанные явно, имеют больший приоритет, чем packagist, composer поставит наш пакет вместо официального.
Когда же разработчики все-таки примут pull request, достаточно будет отменить изменения в composer.json.

Комментарии (3)


  1. alxkolm
    08.01.2016 10:46

    А вот ссылки на документацию:

    getcomposer.org/doc/05-repositories.md#vcs
    getcomposer.org/doc/04-schema.md#replace


  1. Rathil
    08.01.2016 13:10
    +1

    А разве указать свой репозиторий и вписать имя существующего пакета, он его не заменит?


    1. Beowulfenator
      08.01.2016 14:36

      Спасибо, мне уже указали на мою оплошность. Действительно, так намного проще. Текст я уже обновил.