Instalacja Magento przy użyciu Composera - jak ją przeprowadzić?

Warto zaznaczyć, że w kontekście instalacji Magento istnieje oficjalna dokumentacja, dlatego potraktuj ten poradnik jako bardziej przystępną alternatywę. Jeśli chciałbyś zapoznać się ze wszystkimi detalami, sięgnij do wytycznych od samych twórców platformy.

Magento 2 instalacja – czym jest Composer?

Jak wskazuje tytuł artykułu, do instalacji Magento 2 wykorzystamy tzw. Composer. Narzędzie to jest inaczej systemem zarządzania pakietami dla języka PHP. Dzięki niemu można uzyskać ustandaryzowany format, który usprawnia zarządzanie skryptami i bibliotekami. Warto zaznaczyć, że Composer nie posiada typowego interfejsu użytkownika, dlatego obsługuje się go za pomocą wiersza poleceń.

Zalety Composera:

• Inne oprogramowanie, którego potrzebuje pobierany pakiet, aby sprawnie funkcjonować, jest automatycznie obsługiwane przez samego Composera. Dzięki temu łatwiej jest skupić się na instalacji docelowego oprogramowania.
• Composer umożliwia prostą i automatyczną aktualizację pakietów, z których aktualnie korzystasz.
• Dzięki Composerowi łatwiej jest zarządzać nawet kilkoma projektami developerskimi jednocześnie, gdyż narzędzie potrafi sprawnie rozpoznawać i obsługiwać poszczególne pakiety.

Przejdźmy zatem do tego, jak przygotować się do instalacji Magento 2.

Magento instalacja – podstawowe wymagania

Aby przystąpić do samej instalacji Magento, upewnij się, że spełniasz najważniejsze wymagania. Poniższe zalecenia odnoszą się do wersji Magento 2.4 na dzień 23.11.2020:

• System operacyjny – najlepiej Linux x86-64, CentOS, Ubuntu lub Debian.
• Pamięć – 2 GB pamięci RAM zagwarantują, że rozszerzenia z Magento Marketplace będą sprawnie działały.
• Serwer – Apache 2.4 lub nginx 1.x.
• Baza danych – MySQL 8.0 w przypadku większości instalacji lub MariaDB 10.4 w przypadku Magento Commerce Cloud.
• PHP – Magento wspiera wersję PHP 7.4.0. Możesz skorzystać także z 7.3, jednak nie jest to zalecane.
• PHP OPcache – upewnij się, że jest włączone, aby zapewnić dobrą wydajność.
• Ustawienia PHP – niektóre konfiguracje jak memory_limit pozwalają uniknąć wielu problemów w procesie instalacji.
• Elasticsearch – zalecana wersja to 7.6.x.
• SSL – ważny certyfikat bezpieczeństwa jest konieczny, jeśli chcesz uzyskać adres HTTPS.
• Przydatne technologie – Redis 5.0, Varnish 6.x RabbitMQ 3.8.x, php_xdebug 2.5.x.

Instalacja Magento 2 krok po kroku

Poniżej znajdziesz pięć podstawowych kroków niezbędnych do poprawnej instalacji Magento 2 przy użyciu Composera.

1. Nadaj odpowiednie pozwolenia

Etap ten ma na celu zapewnienie bezpieczeństwa podczas instalacji Magento 2. Jeśli zastosujesz się do poniższych kroków, unikniesz sytuacji, w której nieautoryzowane osoby lub procesy zaszkodziłyby całemu procesowi instalacji. Magento file system owner to zwykle osoba na dzielonym hostingu, która może logować się do Magento jako pojedynczy użytkownik. Jest ona w stanie przesyłać pliki korzystając z FTP i ogólnie zarządzać serwerem webowym. W przypadku prywatnego serwera zalecane jest korzystanie z default 002 unmask.

2. Skonfiguruj Composera

Najnowszą wersję Composera możesz pobrać tutaj. Jeśli nabędziesz narzędzie w ten sposób, będziesz mógł je zainstalować w dowolnym katalogu. Pamiętaj jednak, aby zrobić to na serwerze w katalogu głównym.

Jeśli korzystasz już z terminalu, możesz szybko zainstalować Composera, wpisując odpowiedni skrypt:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '8a6138e2a05a8c28539c9f0fb361159823655d7ad2deecb371b04a83966c61223adc522b0189079e3e9e277cd72b8897') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"

3. Wygeneruj klucze uwierzytelniające

Aby uzyskać klucze uwierzytelniające potrzebne do instalacji Magento, wykonaj następujące czynności:

1. Zaloguj się na stronie Magento Marketplace.
2. Przejdź do swojego Profilu.
3. Przejdź do Marketplace > My products > Access Keys.
4. Przejdź do zakładki Magento 2 – możesz tam stworzyć nowy Access Key i nadać mu odpowiednią nazwę.

Uzyskasz dzięki temu dwa klucze:

• Public Key – będzie on służył jako nazwa użytkownika.
• Private Key – będzie on służył jako hasło.

4. Uzyskaj metapaczkę

Aby uzyskać metapaczkę (metapackage) potrzebną przy instalacji Magento 2:

1. Zaloguj się na serwer Magento jako wspomniany wcześniej Magento file system owner.
2. Przejdź na obecny docroot directory serwera webowego.
3. Utwórz nowy projekt w Composerze, wykorzystując do tego odpowiednie polecenie.

Jeśli chodzi o ostatni punkt, musisz wpisać inną komendę w zależności od tego, z jakiej wersji Magento korzystasz:

Magento Open Source:

$ composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>

Magento Commerce:

$ composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>

Jeśli zostaniesz o to poproszony, wpisz uzyskane wcześniej klucze uwierzytelniające.

5. Zainstaluj Magento

Zanim instalacja Magento 2 będzie mogła zostać sfinalizowana, musisz nadać odpowiednie pozwolenia serwerowi grupowemu za pomocą następującej komendy:

cd /var/www/html/<magento install directory>
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data . # Ubuntu
chmod u+x bin/magento

Gdy już to zrobisz, będziesz w stanie użyć linii poleceń, aby zainstalować Magento. W poniższym przykładzie wychodzimy z założenia, że folder instalacyjny nazywa się magento2ee, db-host, znajduje się na tej samej maszynie (localhost), a nazwa użytkownika i hasło to magento:

$ bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=pl_US \
--currency=PLN \
--timezone=Europe/Warsaw\
--use-rewrites=1

Magento 2 instalacja – podsumowanie

Dzięki temu poradnikowi zapewne już lepiej orientujesz się w tym, jak przebiega proces instalacji Magento 2 za pomocą Composera. Jak widać, w grę wchodzi wiele czynności. Jeśli zależy Ci na tym, aby wszystko przebiegło jak najsprawniej, powierz to zadanie specjalistom.