3.5. Використання Composer і Git для завантаження файлів

Last updated on

14 April 2025

Мета

Використання Composer для завантаження та оновлення файлів і залежностей в ядрі, або доданих модулях чи темах. Пропустіть цю тему якщо ви не використовуєте Composer.

Необхідні знання

Розділ 3.2, «Основи: Додаткові інструменти»

Вимоги до сайту

Якщо ви хочете використовувати Composer, він повинен бути встановлений або на сервері вашої локальної розробки або на живому сайті. Дивіться Розділ 3.2, «Основи: Додаткові інструменти».

Кроки

Якщо ви не можете встановити інструмент Composer на свій сервер, ви можете слідувати кроками в будь-якому з розділів нижче на вашому локальному сервері, і потім перенести всі оновлені або додані файли на ваш сервер для живого сайту. Рекомендована процедура полягає в тому, щоб зробити архів або zip-файл з нових і змінених директорій, перенести архів на ваш сервер для живого сайту, видалити директорії, які були змінені, і розпакувати архів. Обов’язково перевіряйте наявність оновлень і доповнень в наступних файлах, в корені вашої установки:

vendor directory
autoload.php
composer.json
composer.lock

Використання Composer для завантаження ядра

Виконайте наступні дії, якщо ви ще не завантажили або що не встановили ядро, і ви хочете використовувати Composer для завантаження ядра і його зовнішніх залежностей:

У командному рядку перейдіть на один рівень вище директорії, де ви хочете розташувати ядро.
Введіть цю команду, де mydir директорія, яку ви хочете створити для проекту:
```
composer create-project drupal-composer/drupal-project: 8.x-dev mydir --no-interaction
```
Останній випуск ядра буде встановлений в mydir/web піддиректорії; Ви отримаєте деякі додаткові інструменти, такі як Drush і Drupal Console в mydir/vendor директорії.

Перетворення раніше завантаженого сайту в Composer

Якщо ви раніше завантажували ядро без використання Composer, ви можете виявити, що ви хочете або повинні використовувати Composer для управління або поновлення залежностей. Щоб перенести ваш існуючий сайт на використання Composer, введіть наступні команди в корені вашого сайту:

composer global require grasmash/composerize-drupal
composer composerize-drupal --composer-root=. --drupal-root=.

Зверніть увагу, що це також зробить модулі, теми і профілі, які ви раніше завантажували без використання Composer, доступними для Composer, якщо вони були поміщені в директоріях modules/contrib, themes/contrib, and profiles/contrib. Якщо ви розмістили їх в іншому місці, ви можете розглянути можливість видалити раніше встановлення модулі і теми, а потім слідувати інструкціям нижче, щоб повторно завантажити їх за допомогою Composer.

Використання Composer для завантаження модулів або тем

Виконайте наступні дії, якщо ви вже використовуєте Composer для управління ядром, і ви хочете використовувати Composer для додавання модуля або теми з їх залежностями.

Кожен раз, коли ви хочете додати модуль або тему, визначте коротку назва проекту. Це остання частина URL сторінки проекту; наприклад, модуль Geofield, в https://www.drupal.org/project/geofield, має коротку назву geofield.
Щоб завантажити модуль або тему, разом з їх зовнішніми залежностями, введіть наступну команду в корені вашого сайту (змінивши коротку назва модуля або теми для geofield):
```
composer require drupal/geofield
```

Використання Composer для поновлення раніше завантажених файлів

Виконайте наступні дії, щоб оновити файли ядра, модуля або теми, після того як почали керувати залежностями через Composer:

Визначте коротку назва проекту, який ви хочете оновити. Для ядра це core. Для модулів або тем, це остання частина URL сторінки проекту; наприклад, модуль Geofield, в https://www.drupal.org/project/geofield, має коротку назву geofield.
Якщо ви хочете оновити до останньої стабільної версії, використовуйте наступні команди, підставляючи коротку назву проекту для поновлення geofield:
```
composer update drupal/geofield --with-dependencies
```
Якщо вам потрібна конкретна версія, до номера якої версії ви хочете оновитися. Наприклад, для модуля версії 8.x-1.7, ви будете вводити тільки 1.7, а для версії ядра 8.3.1, ви будете вводити 8.3.1. Потім введіть наступну команду в корені вашого сайту (Підставивши коротку назву проекту замість geofield і правильний номер версії):
```
composer require drupal/geofield:1.7
```

Поліпшіть своє розуміння

Ви можете дізнатися більше про команди Composer за допомогою системи довідки Composer. Наприклад, щоб дізнатися більше про команду create-project, введіть Composer help create-project в вашому командному рядку терміналу.

Відео

Using Composer and Git to Download Files

Додаткові документи

Автори

Адаптовано Jennifer Hodgdon, Hans Fredrik Nordhaug, і Joe Shindelar із Drupalize.Me від "Using Composer to manage Drupal site dependencies", авторські права 2000-2025 за окремими учасниками Drupal Community Documentation.

Перекладено Олексій Бондаренко із Mazaltov.

This page is generated from AsciiDoc source from the User Guide. To propose a change, edit the source and attach the file to a new issue in the User Guide project. PDF and e-book formats are available on the User Guide project page.

Source file: install-composer.asciidoc

Help improve this page

Page status: No known problems

You can:

On this page

Розділ 3. Встановлення