Snabbstart av lokal installation
Instruktionerna på den här sidan beskriver hur du installerar Adobe Commerce på en självvärdbaserad infrastruktur. Mer information om hur du uppgraderar en befintlig installation finns i uppgraderingshandboken.
Adobe använder Composer för att hantera Adobe Commerce-komponenter och deras beroenden. Att använda Composer för att hämta Adobe Commerce-metapaketet ger följande fördelar:
- Återanvänd bibliotek från tredje part utan att paketera dem med källkod
- Minska antalet tilläggskonflikter och kompatibilitetsproblem genom att använda en komponentbaserad arkitektur med robust beroendehantering
- Ansluta till standarden PHP-Framework Interoperability Group (FIG)
- Paketera Magento Open Source med andra komponenter
- Använda Adobe Commerce i produktionsmiljö
Förutsättningar
Innan du fortsätter måste du göra följande:
- Slutför alla nödvändiga aktiviteter.
- Installera disposition.
- Hämta autentiseringsnycklar till Adobe Commerce Composer-databasen.
Logga in som ägare av filsystemet
Läs mer om ägarskap, behörigheter och filsystemets ägare i Översikt över ägarskap och behörigheter.
Så här byter du till filsystemets ägare:
-
Logga in på programservern som, eller växla till, en användare med behörighet att skriva till filsystemet.
Om du använder basskalet kan du använda följande syntax för att växla till filsystemets ägare och ange kommandot samtidigt:
code language-bash su <file system owner> -s /bin/bash -c <command>
Om filsystemets ägare inte tillåter inloggningar kan du göra följande:
code language-bash sudo -u <file system owner> <command>
-
Om du vill köra CLI-kommandon från en katalog lägger du till
<app_root>/bin
i systemetPATH
.Eftersom skal har olika syntaxer bör du läsa en referens som unix.stackexchange.com.
Exempel på basgränssnitt för CentOS:
code language-bash export PATH=$PATH:/var/www/html/magento2/bin
Du kan också köra kommandona på följande sätt:
cd <app_root>/bin
och kör dem som./magento <command name>
app_root>/bin/magento <command name>
<app_root>
är en underkatalog till webbserverns docroot
Hämta metapackage
Så här hämtar du Adobe Commerce metapaket:
-
Logga in på programservern som, eller växla till, ägare av filsystemet.
-
Byt till webbserverns dokumentkatalog eller en katalog som du har konfigurerat som ett virtuellt värddokument.
-
Skapa ett Composer-projekt med ett Commerce-metapaket.
Magento Open Source
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-community-edition <install-directory-name>
Adobe Commerce
code language-bash composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>
Ange dina autentiseringsnycklar när du uppmanas att göra det. Offentliga och privata nycklar skapas och konfigureras i Commerce Marketplace.
note note NOTE När du använder en Composer auth.json
-fil eller miljövariabel uppmanas du inte att ange dina autentiseringsnycklar.Om du stöter på fel, till exempel
Could not find package...
eller...no matching package found
, kontrollerar du att det inte finns några stavfel i kommandot. Om du fortfarande råkar ut för fel kanske du inte har behörighet att ladda ned Adobe Commerce. Kontakta Adobe Commerce Support om du behöver hjälp.Se Felsökning om du behöver hjälp med fler fel.
Exempel - Mindre version
Mindre releaser innehåller nya funktioner, kvalitetskorrigeringar och säkerhetskorrigeringar. Använd Composer för att ange en mindre release. Om du till exempel vill ange metapaketet för Adobe Commerce 2.4.6:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
Exempel - Kvalitetskorrigering
Kvalitetsuppdateringar innehåller i första hand funktionella - och-säkerhetskorrigeringar. De kan dock ibland även innehålla nya bakåtkompatibla funktioner. Använd Composer för att hämta en kvalitetskorrigering. Om du till exempel vill ange metapaketet för Adobe Commerce 2.4.6:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>
Exempel - Säkerhetsuppdatering
Säkerhetsuppdateringar innehåller endast säkerhetskorrigeringar. De är utformade för att göra uppgraderingsprocessen snabbare och enklare.
Säkerhetsuppdateringar använder Composer-namnkonventionen 2.4.6-px
. Använd Composer för att ange en korrigering. Om du till exempel vill hämta metapaketet Adobe Commerce 2.4.6-p1:
composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>
Ange filbehörigheter
Du måste ange läs- och skrivbehörighet för webbservergruppen innan du installerar Adobe Commerce. Detta är nödvändigt för att kommandoraden ska kunna skriva filer till filsystemet.
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
Installera programmet
Du måste använda kommandoraden för att installera Adobe Commerce.
I det här exemplet antas att installationskatalogen har namnet magento2ee
, att db-host
finns på samma dator (localhost
) och att db-name
, db-user
och db-password
alla är 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=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15
--backend-frontname
. Adobe rekommenderar dock att du utelämnar det här alternativet och låter installationskommandot automatiskt generera en slumpmässig URI. En slumpmässig URI är svårare för hackare eller skadlig programvara att utnyttja. URI:n visas i konsolen när installationen är klar.Sammanfattning av kommandon
Om du vill visa en fullständig lista med kommandon anger du:
bin/magento list
Om du vill ha hjälp för ett visst kommando anger du:
bin/magento help <command>
Exempel:
bin/magento help setup:install
bin/magento help cache:enable
Följande tabell sammanfattar de tillgängliga kommandona. Kommandon visas endast i sammanfattningsform. Mer information om ett kommando får du om du klickar på länken i kolumnen Kommando.
magento setup:install
magento setup:uninstall
magento setup:upgrade
magento maintenance:{enable/disable}
magento setup:config:set
magento module:{enable/disable}
magento setup:store-config:set
magento setup:db-schema:upgrade
magento setup:db-data:upgrade
magento setup:db:status
magento admin:user:create
Distributionskonfiguration
Aktivera minst databasen
Magento_User
och Magento_Authorization
modules(enklaste sättet är att använda
bin/magento setup:upgrade
)magento list
magento help
Vanliga argument
Följande argument är gemensamma för alla kommandon. Dessa kommandon kan köras antingen före eller efter att programmet har installerats:
--help
-h
./magento help setup:install
eller ./magento help setup:config:set
.--quiet
-q
--no-interaction
-n
--verbose=1,2,3
-v, -vv, -vvv
--verbose=3
eller -vvv
visar till exempel felsökningsintensiteten, som är den mest detaljerade utdata. Standardvärdet är --verbose=1
eller -v
.--version
-V
--ansi
--no-ansi