Instalacja (pobieranie) Drupal 10 za pomocą Composera

Jeśli chcesz zainstalować nowy projekt, musisz to zrobić za pomocą Composera, a nie jak dotychczas Drusha. Oczywiście nadal będziesz korzystać z tego narzędzia, ale wyłącznie do instalacji modułów lub motywów, a nie do ich pobierania.

Główną zaletą używania narzędzia Composer jest możliwość systematycznego i przejrzystego zarządzania wymaganiami (oraz wymaganiami podrzędnych modułów), a także pewność, że zainstalowałeś poprawną i aktualną wersję modułu czy motywu. Instalację Drupala za pomocą Composera może ułatwić oficjalny projekt, który zawiera informacje i szablony.

Pierwszą rzeczą, jaką musisz zrobić, to zainstalować Composera. Zobacz więc przewodnik, jak zainstalować to narzędzie.

Aby utworzyć nowy projekt, bazując na oficjalnym wzorze, musisz uruchomić następującą komendę:

composer create-project drupal/recommended-project folder_projektu

Pobierze ona paczkę drupal/recommended-project do folderu folder_projektu. Zostanie także automatycznie uruchomiona komenda composer install, która pobierze rdzeń Drupala 10 oraz wszystkie wymagane elementy. Pamiętaj przy tym o zmianie nazwy folder_projektu na własną.

Jeśli zainstalujesz projekt w oparciu o plik composer.json, dostarczony razem ze wzorcem projektu, zobaczysz zmiany w odniesieniu do standardowego sposobu instalacji Drupala:

1. Drupal zostanie zainstalowany do folderu web.
2. Autoloader wygenerowany przez Composera będzie w vendor/autoload.php, podczas gdy autoloader Drupala znajduje się w web/vendor/autoload.php.
3. Moduły (paczki typu drupal-module) zostaną umieszczone w web/modules/contrib.
4. Motywy (paczki typu drupal-theme) zostaną umieszczone w web/themes/contrib.
5. Profile (paczki typu drupal-profile) zostaną umieszczone w web/profiles/contrib.
6. Zostaną stworzone domyślne, zapisywalne wersje settings.php oraz services.yml.
7. Zostanie utworzony folder web/sites/default/files.
8. Najnowsza wersja Drusha zostanie zainstalowana lokalnie, dostępna pod vendor/bin/drupal.
9. Zostaną stworzone zmienne środowiskowe bazujące na pliku .env.

Projekt zawiera także podstawowy plik .gitignore, w którym wykluczone są wszystkie foldery zawierające paczki instalowane za pomocą Composera. Dlatego, gdy masz aktualny plik composer.json, łatwo możesz odbudować instalację Drupala.

Załóżmy, że potrzebujesz zainstalować swoją stronę w folderze docroot/ lub public_html/. W tym przypadku musisz ręcznie sklonować wzór projektu do folderu:

git clone https://github.com/drupal/recommended-project.git folder_projektu

Następnie przejdź do folderu projektu i edytuj plik composer.json. W sekcji extras/installer-paths zmień ścieżki z web/ na interesujący Cię katalog. Następnie uruchom komendę composer install.

Skoro pobrałeś już projekt, możesz go zainstalować za pomocą Drush, używając komendy drush site:install lub przejść do lokalnej strony http://localhost/.

Pobieranie paczek ze strony drupal.org sprowadza się do jednej prostej komendy, jaką jest composer require. Przykładowo, kiedy chcesz zainstalować moduł Pathauto, musisz przejść do podstrony rozszerzenia.

Tam już w pierwszych linijkach znajduje się prosta komenda, którą musisz wykonać w projekcie. Zasada budowy komendy sprowadza się do zapamiętania składni, jaką jest composer require: nazwa_repozytorium/nazwa_mechaniczna_paczki - nazwa_repozytorium w przypadku drupal.org to drupal, a nazwa_mechaniczna_paczki dla Pathauto, to po prostu pathauto.

Po pobraniu modułu musisz go rzecz jasna zainstalować. Możesz to zrobić za pomocą komendy drush pm:install pathauto.

Aktualizacja zależności odbywa się poprzez uruchomienie komendy composer update, które po przetestowaniu możesz dołączyć do swojego repozytorium git. Aby odwzorować środowisko na wersji zdalnej, musisz na serwerze uruchomić composer install. Wtedy wszystkie paczki wraz z rdzeniem Drupala, zostaną pobrane do katalogu Twojego projektu. Wszystko przez to, że podczas aktualizacji obecne wersje zapisywane są w specjalnym pliku composer.lock.

Narzędzie Composer w znacznym stopniu przyspiesza prace związane z Drupalem oraz poprawia bezpieczeństwo. Aktualizacja Drupala i jego zależności sprowadza się do jednej prostej komendy, a w repozytorium masz jasny podgląd, jakie paczki modułów są w tym projekcie wykorzystywane. Jeśli instalacja systemu przez Composer sprawia Ci trudność, zasięgnij porady ekspertów.