====== Magento ======

Magento to platforma do uruchamiania sklepów internetowych (eCommerce). Projekt może być dostosowywany przez deweloperów do specyficznych potrzeb klienta poprzez rozszerzanie klas PHP.

===== Instalacja =====

<WRAP center round important 90%>
Przed rozpoczęciem instalacji upewnij się, że masz dokładnie taką wersję PHP, jakiej wymaga najnowsze Magento.
</WRAP>

1. Zainstaluj [[XAMPP]] albo [[WampServer]], oraz [[Elasticsearch]]. Dodaj PHP do Path (np. ''C:\wamp\bin\php\php8.0''). Jeżeli robisz instalację produkcyjną, zobacz [[linux:lamp]].

2. Zainstaluj Composer z getcomposer.org. Composer wymaga PHP.

3. Utwórz konto na stronie https://marketplace.magento.com

4. Wygeneruj Access Keys: My Profile -> Access Keys.

5. Zwiększ limit pamięci w ''php.ini''.

  memory_limit = 256M

6. Włącz następujące biblioteki w ''php.ini'', zarówno dla wersji konsolowej, jak i webowej interpretera PHP:

<code ini>
extension=bz2
extension=curl
extension=fileinfo
extension=gd2
extension=gettext
extension=intl
extension=mbstring
extension=exif      ; Must be after mbstring as it depends on it
extension=mysqli
extension=openssl
extension=pdo_mysql
extension=soap
extension=sockets
extension=sodium
extension=xsl
</code>

W [[WampServer]] lokalizacja pliku konfiguracyjnego będzie czymś w rodzaju:

  * Wersja konsolowa (jeśli dodałeś ''C:\wamp\bin\php\php8.0'' do Path):
  ''C:\wamp\bin\php\php8.0\php.ini''

  * Wersja dla Apache (w ''C:\wamp\bin\apache\apache2.4.46\bin'' powinien być skrót ''php.ini'', który prowadzi do tego pliku). Ten sam plik można konfigurować z menu [[WampServer]].
  ''C:\wamp\bin\php\php8.0\phpForApache.ini''

Aktywne rozszerzenia możesz wyświetlić poleceniem:

<code bash>
php -m
</code>

7. Pobierz Magento poniższym poleceniem (przyjęto, że Twój katalog/projekt nazywa się "magento" - ostatni parametr).

<code bash>
composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition magento
</code>

Kiedy instalator zapyta o login i hasło, użyj wcześniej wygenerowanych kluczy ''Access Key'' do zalogowania się: Public Key jako Username, Private Key jako Password.

8. Utwórz bazę danych dla aplikacji.

Zaloguj się na konto roota.
<code bash>
mysql -u root -p
</code>

Utwórz nową bazę danych i użytkownika.
<code mysql>
CREATE DATABASE IF NOT EXISTS magento CHARACTER SET 'utf8' COLLATE utf8_polish_ci;
GRANT ALL PRIVILEGES ON magento.* TO 'magento'@'localhost' IDENTIFIED BY 'magento';
FLUSH PRIVILEGES;
</code>

Wylistowanie istniejących użytkowników.
<code mysql>
SELECT host, user, password FROM mysql.user ORDER BY user, host;
</code>

9. Przejdź do katalogu z projektem i zainstaluj Magento poniższym poleceniem. Przed wklejeniem go do konsoli, wstaw właściwe parametry.

<code bash>
php bin/magento setup:install \
--base-url=http://localhost/magento \
--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_PL \
--currency=PLN \
--timezone=Europe/Warsaw \
--use-rewrites=1
</code>

Hasło musi mieć przynajmniej 7 znaków oraz zawierać litery i cyfry.

Jeśli wszystko przebiegło pomyślnie, otwórz 127.0.0.1/magento.

Jest to skrócona wersja instrukcji instalacyjnej. Pełna, szczegółowa dokumentacja znajduje się na stronie https://devdocs.magento.com/guides/v2.4/install-gde/composer.html.