Настройка и работа с Platform Version

На техническом уровне Pimcore Platform Version подключается как зависимость через Composer и может быть добавлена в файл composer.json проекта.

Настройка Platform Version

Настройка в существующем проекте

Выполните следующие шаги, чтобы подключить Platform Version в уже существующий проект:

• Установите Platform Version командой composer require pimcore/platform-version и следуйте дальнейшим инструкциям по установке других модулей Pimcore. Возможно, потребуется скорректировать версии других пакетов pimcore/* в соответствии с требованиями Platform Version. Ориентируйтесь на подсказки Composer.

Настройка в новом проекте

Чтобы настроить Platform Version в новом проекте, выполните:

• Получите шаблон проекта: composer create-project pimcore/skeleton my-project.
• Установите Platform Version: composer require pimcore/platform-version. Возможно, потребуется адаптировать версии других пакетов pimcore/* согласно требованиям Platform Version.
• Выполните команду: composer update для установки всех необходимых зависимостей, после чего можно подключать дополнительные модули Pimcore.

Работа с Platform Version

После установки Platform Version вы можете подключать совместимые модули Pimcore и обновлять установленные модули до актуальных версий

Установка дополнительных модулей Pimcore

Для установки дополнительных модулей используйте: composer require pimcore/<MODULE>.

Если Composer не может найти подходящую версию модуля, попробуйте указать версию с :*

Обновление модулей Pimcore

Обновление до новых багфикс-версий

Вы можете устанавливать багфикс-версии модулей в рамках текущей Platform Version с помощью стандартной команды: composer update. Composer подтянет последние исправления для всех отслеживаемых модулей.

Обновление до новой Platform Version

• Перед обновлением обязательно ознакомьтесь с Release Notes.
• Обновление до новой Pimcore Platform Version:
  • Чтобы обновиться до конкретной версии: composer require pimcore/platform-version:2023.1 --no-update для обновления вашего composer.json. После этого выполните: composer update.
  • Чтобы обновиться до последней доступной версии (если ваш composer.json это допускает): composer update pimcore/platform-version.

Советы

В некоторых случаях может потребоваться добавить pimcore/* в зависимости, чтобы Composer корректно разрешил версии модулей из Pimcore-репозитория.

Важно

Репозиторий pimcore/platform-version не указывает список необходимых пакетов, а только определяет конфликтующие зависимости, чтобы гарантировать совместимость. Команда composer require pimcore/platform-version --update-with-all-dependencies не будет работать. Команда composer require проверяет зависимости на основе composer.lock и может завершиться с ошибкой. Для полного обновления пакетов нужно использовать: composer update.

Предупреждение

Иногда может понадобиться установить модуль Pimcore в версии, которая не входит в Platform Version. В этом случае удалите зависимость platform-version из composer.json и обновите нужный модуль вручную до желаемой версии. Учтите, что при этом вы получите теоретически совместимую, но непроверенную комбинацию версий модулей Pimcore.