Руководство по загрузке

Загрузка Drupal — процесс, в результате которого вы загружаете исходный код системы. Данный код необходим, для того чтобы начать работать с Drupal и приступить к его установке.

Варианты загрузки Drupal

Существует множество способов как и где можно загрузить Drupal, среди них можно выделить два основных:

  1. Загрузка Drupal при помощи Composer, используя один из шаблонов проекта: drupal/core-recommended-project или drupal/legacy-project.
  2. (не рекомендуется) Загрузка архива с исходным кодом со страницы проекта Drupal.

Каждый из вариантов имеет как свои плюсы, так и минусы. Рекомендуется использовать загрузку ядра при помощи Composer, так как это самый лучший и простой вариант.

Загрузку при помощи архива можно считать устаревшим способом, используйте его лишь в качестве быстрого способа получить исходный код Drupal в образовательных целях. На реальных проектах, со временем, с ним возникнет множество проблем и неудобств, а количество времени и уровень навыков, которые потребуются на их решение, многократно превысят время на изучение Composer. Более того, в конце концов данный вариант всё равно приведёт к использованию Composer на проекте, при этом у вас получится гибрид, который, опять-таки, потребует куда большего уровня и времени для поддержки. Настоятельно не рекомендуется использовать данный способ; так вы сохраните себе много времени и нервов.

Подготовка

Для того чтобы загрузить Drupal при помощи Composer, вам необходимо, чтобы данный инструмент был доступен в окружении, в котором вы хотите его использовать. Если он отсутствует, воспользуйтесь руководством по установке Composer (Composer можно установить на любой хостинг, где есть PHP).

Далее вам необходимо выбрать, какой шаблон проекта вы собираетесь использовать для будущего сайта. Более подробно о каждом из них вы можете прочитать на соответствующих страницах. Рекомендуется использовать drupal/core-recommended-project.

Загрузка кода при помощи Composer

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

composer -n create-project drupal/recommended-project my_new_site

где my_new_site — название директории, в которую будет загружен проект (относительно текущей директории). Для более подробной информации и сведений о доступных опциях обратитесь к документации Composer.

Совет

Вместо my_new_site вы можете указать . (точка) для загрузки проекта в текущую директорию. Для этого она должна быть пустой. Вы можете указать любой абсолютный или относительный путь для загрузки.

Совет

Если вы столкнулись с ошибкой «Project directory "/var/www/html/." is not empty.», скорее всего, в директории, куда вы загружаете проект, уже имеются файлы и папки. В таком случае проще загрузить в конкретную папку, а затем перенести загруженные файлы, например rsync -avh --delete-after ./my_new_site/ ./ — данная команда перенесёт все файлы из папки my_new_site в текущую директорию, после чего удалит их из my_new_site.

Дождитесь окончания загрузки — и всё готово!

Дальнейшие шаги

Если вы загрузили Drupal в соответствии с рекомендациями, в конце вам будет показано сообщение с дальнейшими действиями и ссылками на официальную документацию Drupal (на английском). С ними рекомендуется ознакомиться.

После успешной загрузки рекомендуется удалить пакет, выводящий поздравительное сообщение, чтобы оно не выводилось каждый раз. Для этого воспользуйтесь командой:

composer remove drupal/core-project-message

Хорошо будет также удалить раздел настроек данного плагина extra.drupal-core-project-message в composer.json файле вашего проекта.

Далее можете приступать к установке Drupal.

См. также

Ссылки

🌱 Помогите нам сделать документацию лучше!

Вся документация Druki с отрытым исходным кодом. Нашли ошибку или неточность? Создайте pull request.

Редактировать текущий документ Обсудить улучшение

Или узнайте как контрибутить.

🤔 По-прежнему нужна помощь?

Не нашли ответа на свой вопрос? Попросите помощи у сообщества!

Задайте вопрос на GitHub Смотрите другие ресурсы сообщества