Установка Drupal 8 с помощью Composer (Composer Drupal 8)

Установка Drupal 8 с помощью Composer (Composer Drupal 8)

Composer - это менеджер зависимостей для PHP. Drupal использует его для управления пакетами, входящими в состав ядра, например, Symfony и Guzzle. В данной статье мы установим с помощью Composer Drupal 8.

Если кратко, то Composer позволяет нам управлять постоянно растущем списком зависимостей, а также их дочерними зависимостями. С его помощью можно скачивать, проверять и подключать указанные в конфигурационном файле пакеты, обеспечивая при этом использование правильных версий. Возможно это сложно понять с первого раза, однако нет ничего хуже, чем использование собственных велосипедов.

Composer и Drupal

Если вы заглянете в репозиторий Drupal, то наверняка заметите, что там напрочь отсутствует папка vendors, это происходит потому, что необходимы Друпалу пакеты не передаются в репозиторий. Вместо этого в репозитории есть файлы composer.json и composer.lock, первый отвечает за список зависимостей, второй за необходимые версии пакетов.

Есть два способа установки Drupal:

  • Можно скачать архив .zip или .tar.gz с сайта Drupal.org или же использовать Drush. При таком раскладе все необходимые пакеты будут автоматически установлены в папку с сайтом;
  • Второй же метод позволяет вручную скачать ядро Друпал и настроить все зависимости через Composer. Вот его мы сегодня и рассмотрим.

Использование Composer для управления зависимостями Drupal

Установка Composer

Вам необходимо установить Composer перед так как приступить к созданию проекта на Drupal. Сделать это можно следуя инструкции на официальном сайте Getting Started на офф. сайте getcomposer.org.

Скачиваем ядро Drupal 8 с помощью Composer

В терминале выполняем команду:

composer create-project drupal/drupal my_site_name_dir

Данная команда скачивает drupal/drupal в папку "my_site_name_dir". Также автоматически запускается команда composer install, которая устанавливает все необходимы Drupal пакеты.

Небольшая заметка для git-cloned drupal/drupal

Если вы хотите последнюю dev-версию Друпа используя git, то вам также придется вручную установить все необходимые для данной версии зависимости, указанные в файле composer.json.

В корневой директории проекта запустите в терминале команду:

composer install

Эта команда скачается все необходимые для работы Друпала пакеты.

Обновление Drupal 8 с помощью Composer

Для обновления Drupal 8 с помощью композера необходимо выполнить следующие шаги:

  1. Сделайте резервную копию сайта
  2. Активируйте maintenance mode
  3. Выполните команду
    composer outdated​
  4. Затем выполните:
    composer update drupal/modulename --with-dependencies​
  5. С помощью Drush выполните:
    drush updb && drush entup​
  6. И очистите кеш командой:
    drush cr​
  7. Удостоверьтесь, что сайт работает правильно после обновления
  8. Готово! Вы успешно обновили Drupal 8 с помощью Composer.