Установка

Magento устанавливают в два шага: Composer скачивает файлы, а команда setup:install создаёт таблицы в базе и первого администратора. К этому моменту должны работать PHP, MySQL и OpenSearch, а в MySQL должна существовать пустая база, например shop.

Ключи доступа

Пакеты Magento лежат в хранилище repo.magento.com. Оно требует ключи: их бесплатно создают в личном кабинете на сайте Adobe Commerce Marketplace, в разделе Access Keys. Composer спросит имя пользователя и пароль — это открытый и закрытый ключ соответственно.

Создание проекта

composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition shop
cd shop

Composer создаст папку shop и скачает в неё ядро. Это занимает несколько минут.

Установщик

bin/magento setup:install \
  --base-url=http://shop.test/ \
  --db-host=localhost --db-name=shop --db-user=root --db-password=secret \
  --admin-firstname=Anna --admin-lastname=Smith --admin-email=admin@example.com \
  --admin-user=admin --admin-password=Secret123 \
  --backend-frontname=admin \
  --search-engine=opensearch --opensearch-host=localhost --opensearch-port=9200

Команда создаёт таблицы, администратора admin и файл настроек app/etc/env.php. В конце она печатает сообщение об успешной установке и адрес панели управления.

Параметр	Что задаёт
`--base-url`	Адрес магазина, с косой чертой в конце
`--db-*`	Подключение к базе данных
`--admin-*`	Учётную запись первого администратора
`--backend-frontname`	Адрес панели: `admin` даст `/admin`
`--opensearch-*`	Подключение к поисковому сервису

Веб-сервер

Корнем сайта должна быть папка pub внутри проекта, а не сам проект. Для Nginx в проекте есть готовый образец настроек — файл nginx.conf.sample.

Проверка

Откройте http://shop.test/ — появится пустая витрина с темой Luma. Панель управления находится по адресу http://shop.test/admin.

Двухэтапный вход

В Magento 2.4 вход в панель требует второй шаг — код из приложения. На локальной копии это мешает, и модули входа обычно отключают:

bin/magento module:disable Magento_AdminAdobeImsTwoFactorAuth Magento_TwoFactorAuth
bin/magento cache:flush

После этого в панель пускают по имени и паролю. На рабочем сервере эти модули не отключают.

Демонстрационные товары

bin/magento sampledata:deploy
bin/magento setup:upgrade

Первая команда скачивает модули с примерами, вторая устанавливает их. В каталоге появятся товары и категории — на них удобно проверять код из следующих уроков.

Частая ошибка

Установщик останавливается с сообщением о недоступном поисковом сервисе, если OpenSearch не запущен или указан неверный адрес. Проверьте его до установки: запрос curl http://localhost:9200 должен вернуть JSON с номером версии.

Спасибо, что читаете!