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

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

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

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

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

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

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

Подготовка

Для того чтобы загрузить 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.

См. также

Ссылки

Помощь и обратная связь

Если вы обнаружили ошибку или хотите внести улучшения, и желаете внести изменения самостоятельно при помощи Pull Request
Если вы желаете предложить улучшение для этого документа

Обратиться за помощью

Если вы не нашли то что искали, воспользуйтесь поиском.

Если вам нужна помощь с чем-то конкретным, обратитесь к сообществу.