Rozszerzanie Drupala 10 za pomocą Composera.

Poznaj DrupalaPierwsze kroki
Obecnie moduły dodatkowe Drupala dość często polegają na zewnętrznych bibliotekach. Niektóre z tych modułów instaluje się wyłącznie za pomocą Composera. Jeśli jądro Drupala pobrano już za pomocą Composera albo moduł wymaga Composera, pobieraj wszystkie moduły i motywy za pomocą Composera. Jeśli mieszasz aktualizacje Composera z innymi metodami, możesz wpaść w dość kłopotliwe problemy z aktualizacjami.
 

Pobieranie modułów i motywów dodatkowych za pomocą Composera

Chcesz pobrać dodatkowe moduły lub motywy Drupala za pomocą Composera? Oto jak:

  • Wpisz composer require drupal/module_name
  • Na przykład: composer require drupal/token
  • Upewnij się, że jesteś w katalogu głównym instalacji Drupala

Composer zaktualizuje wtedy plik composer.json, dodając moduł do listy pozostałych wymagań, tak jak tutaj:

{
    "require": {
        "drupal/token": "^1.5"
    }
}

Composer pobierze moduł i wszystkie jego zależności.

Aby włączyć moduł Drupala, masz dwie możliwości:

  • Użyj standardowego interfejsu Drupala w przeglądarce, klikając Rozszerz na pasku narzędzi.
  • Wypróbuj narzędzie wiersza poleceń, takie jak Drush albo Drupal Console - zobacz Instalowanie modułów z wiersza poleceń.

Dołączając moduły, podaj nazwę projektu albo nazwę konkretnego modułu w projekcie:

  • Composer pobierze cały projekt zawierający dany moduł.
  • Na przykład, jeśli potrzebujesz modułu fe_block z projektu features_extra, wybierz jedną z następujących opcji:
    • composer require drupal/features_extra
    • composer require drupal/fe_block
 

Wybór wersji

Aby podać wersję pobieranego modułu lub motywu, zrób tak:

composer require 'drupal/module_name:version'

(Zastąp po prostu version prawdziwą wersją Composera albo ograniczeniem wersji.)

Na przykład:

composer require 'drupal/dxpr_builder:^1.1' 
composer require 'drupal/dxpr_builder:~1.1' 
composer require 'drupal/dxpr_builder:2.2.2-alpha2' 
composer require 'drupal/dxpr_builder:2.2.x-dev'

Aby uniknąć problemów w różnych terminalach i powłokach, bierz wersję w cudzysłów, jak w przykładach powyżej.

Uwaga! W systemie Windows użycie (pojedynczego) cudzysłowu może popsuć specyfikację wersji, co kończy się niepowodzeniem instalacji z błędem 'Could not parse version constraint .....': Invalid version string "....'".

Bez cudzysłowu, na przykład:

composer require drupal/dxpr_builder:^2.2

Albo używając podwójnego cudzysłowu zamiast pojedynczego, tak jak tutaj:

composer require "drupal/dxpr_builder:^2.2"

Powinno zadziałać bez problemu. Więcej informacji znajdziesz w artykule Komentarz „Problemy z Composerem: ‚could not parse version constraint’”.

W przykładach powyżej wersje odpowiadają następującym wydaniom:

  • ^1.1: odpowiada najnowszemu stabilnemu wydaniu 10.x-1.x modułu.
  • ~1.1: odpowiada najnowszemu stabilnemu wydaniu 10.x-3.x modułu.
  • 2.2.2-alpha2: odpowiada wersji 2.2.2-alpha2
  • 2.2.x-dev: odpowiada wersji 2.2.x-dev

Więcej o ograniczeniach wersji z ~ (tylda) i ^ (daszek) znajdziesz w artykule Operatory następnego znaczącego wydania.

Warto podawać wersję pobieranego modułu dodatkowego.


Wyszukiwanie za pomocą Composera

Dobra wiadomość! Punkty końcowe Composera na Drupal.org obsługują funkcję wyszukiwania Composera. To znaczy, że projektów Drupala szukasz prosto z wiersza poleceń. Aby użyć wyszukiwania Composera, wpisz:

composer search views
 

Przeglądanie za pomocą Composera

Punkty końcowe Composera na Drupal.org dla Drupala od wersji 7 do 10 obsługują też funkcję przeglądanie Composera. Dzięki temu dodatkowe informacje o projektach Drupala znajdziesz prosto z wiersza poleceń. Aby użyć przeglądania Composera, wpisz:

composer browse drupal/token