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ö
NOTE
Utvecklare som bidrar till Magento Open Source bör använda installationsmetoden git-baserad .

Förutsättningar

Innan du fortsätter måste du göra följande:

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:

  1. 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>
    
  2. Om du vill köra CLI-kommandon från en katalog lägger du till <app_root>/bin i systemet PATH.

    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:

  1. Logga in på programservern som, eller växla till, ägare av filsystemet.

  2. Byt till webbserverns dokumentkatalog eller en katalog som du har konfigurerat som ett virtuellt värddokument.

  3. 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
TIP
Du kan anpassa Admin URI med alternativet --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.
TIP
En fullständig beskrivning av CLI-installationsalternativen finns i Installera programmet från kommandoraden.

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.

Kommando
Beskrivning
Förutsättningar
magento setup:install
Installerar programmet
Ingen
magento setup:uninstall
Tar bort programmet.
Programmet är installerat
magento setup:upgrade
Uppdaterar programmet.
Distributionskonfiguration
magento maintenance:{enable/disable}
Aktiverar eller inaktiverar underhållsläge (i underhållsläge kan bara undantagna IP-adresser komma åt Admin eller storefront).
Programmet är installerat
magento setup:config:set
Skapar eller uppdaterar distributionskonfigurationen.
Ingen
magento module:{enable/disable}
Aktivera eller inaktivera moduler.
Ingen
magento setup:store-config:set
Anger alternativ som är relaterade till butiken, till exempel bas-URL, språk och tidszon.
Distributionskonfiguration
magento setup:db-schema:upgrade
Uppdaterar databasschemat.
Distributionskonfiguration
magento setup:db-data:upgrade
Uppdaterar databasdata.
Distributionskonfiguration
magento setup:db:status
Kontrollerar om databasen är uppdaterad med koden.
Distributionskonfiguration
magento admin:user:create
Skapar en administratör.
Du kan skapa användare för följande:

Distributionskonfiguration

Aktivera minst databasen Magento_User och Magento_Authorization modules

(enklaste sättet är att använda bin/magento setup:upgrade)
magento list
Visar alla tillgängliga kommandon.
Ingen
magento help
Tillhandahåller hjälp för det angivna kommandot.
Ingen

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:

Lång version
Kort version
Betydelse
--help
-h
Få hjälp för alla kommandon. Till exempel ./magento help setup:install eller ./magento help setup:config:set.
--quiet
-q
Tyst läge, inga utdata.
--no-interaction
-n
Inga interaktiva frågor.
--verbose=1,2,3
-v, -vv, -vvv
Detaljnivå. --verbose=3 eller -vvv visar till exempel felsökningsintensiteten, som är den mest detaljerade utdata. Standardvärdet är --verbose=1 eller -v.
--version
-V
Visa den här programversionen
--ansi
n/a
Framtvinga ANSI-utdata
--no-ansi
n/a
Inaktivera ANSI-utdata
NOTE
Grattis! Du har slutfört snabbinstallationen. Behöver du mer avancerad hjälp? Ta en titt på guiden Avancerad installation.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995