Snelle start van de installatie op locatie

De instructies op deze pagina beschrijven hoe te om Adobe Commerce op zelf-ontvangeninfrastructuur te installeren. Voor begeleiding bij de bevordering van een bestaande installatie, zie de Gids van de Verbetering.

De Adobe gebruikt Composerom de componenten van Adobe Commerce en hun gebiedsdelen te beheren. Het gebruik van Composer voor het ophalen van het Adobe Commerce-pakket biedt de volgende voordelen:

  • Bibliotheken van derden opnieuw gebruiken zonder deze te bundelen met broncode
  • Verminder uitbreidingsconflicten en compatibiliteitskwesties door een op componenten-gebaseerde architectuur met robuust gebiedsbeheer te gebruiken
  • Adhere aan PHP-Kader de Groep van de Interoperabiliteit (FIG)normen
  • Magento Open Source opnieuw verpakken met andere componenten
  • De Adobe Commerce-software gebruiken in een productieomgeving
NOTE
De ontwikkelaars die tot Magento Open Source bijdragen zouden de op git-Gebaseerdeinstallatiemethode moeten gebruiken.

Vereisten

Voordat u verdergaat, moet u het volgende doen:

Aanmelden als eigenaar van bestandssysteem

Leer over eigendom, toestemmingen, en de eigenaar van het dossiersysteem in het Overzicht van eigendom en toestemmingenonderwerp.

Ga naar de eigenaar van het bestandssysteem:

  1. Meld u aan bij de toepassingsserver of schakel over naar een gebruiker met schrijfmachtigingen naar het bestandssysteem.

    Als u bash shell gebruikt, kunt u de volgende syntaxis gebruiken om aan de eigenaar van het dossiersysteem over te schakelen en het bevel tezelfdertijd in te gaan:

    code language-bash
    su <file system owner> -s /bin/bash -c <command>
    

    Als de eigenaar van het bestandssysteem geen aanmeldingen toestaat, kunt u het volgende doen:

    code language-bash
    sudo -u <file system owner>  <command>
    
  2. Als u CLI-opdrachten vanuit een willekeurige map wilt uitvoeren, voegt u <app_root>/bin toe aan uw systeem PATH .

    Omdat de cellen verschillende syntaxis hebben, raadpleeg een verwijzing als unix.stackexchange.com.

    Voorbeeld van bash-shell voor CentOS:

    code language-bash
    export PATH=$PATH:/var/www/html/magento2/bin
    

    U kunt de opdrachten optioneel op de volgende manieren uitvoeren:

    • cd <app_root>/bin en voer ze als ./magento <command name> uit
    • app_root>/bin/magento <command name>
    • <app_root> is een submap van de webserverhoofdmap

De metapakket ophalen

Zo krijgt u het Adobe Commerce-pakket:

  1. Login aan uw toepassingsserver als, of schakelaar aan, de eigenaar van het dossiersysteem.

  2. Wijzig de hoofdmap van de webserver of een map die u hebt geconfigureerd als een virtueel hoofddocument van de host.

  3. Maak een Composer-project met een Commerce-metapakket.

    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>
    

    Voer desgevraagd uw verificatietoetsen in. De openbare en privé sleutels worden gecreeerd en in uw Commerce Marketplacegevormd.

    note note
    NOTE
    Wanneer u een Composer auth.json -bestand of een omgevingsvariabele gebruikt, wordt u niet gevraagd om uw verificatietoetsen in te voeren.

    Als er fouten optreden, zoals Could not find package... of ...no matching package found , controleert u of de opdracht geen typos bevat. Als er nog steeds fouten optreden, kunt u geen Adobe Commerce downloaden. Contact {de Steun van 0} Adobe Commerce 🔗 voor hulp.

    Zie het Oplossen van problemenvoor hulp met meer fouten.

Voorbeeld - kleine release

Kleine versies bevatten nieuwe functies, oplossingen voor de kwaliteit en beveiligingsoplossingen. Gebruik Composer om een kleine release op te geven. U kunt bijvoorbeeld als volgt het metapakket Adobe Commerce 2.4.6 opgeven:

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

Voorbeeld - Kwaliteitspatch

De flarden van de kwaliteit bevatten hoofdzakelijk functionele en veiligheidsmoeilijke situaties. Soms kunnen ze echter ook nieuwe, achterwaartse compatibele functies bevatten. Gebruik Composer om een kwaliteitspatch te downloaden. U kunt bijvoorbeeld als volgt het metapakket Adobe Commerce 2.4.6 opgeven:

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

Voorbeeld - Beveiligingspatch

Beveiligingspatches bevatten alleen beveiligingsoplossingen. Ze zijn ontworpen om het upgradeproces sneller en eenvoudiger te maken.

Beveiligingspatches maken gebruik van de naamgevingsconventie van Composer 2.4.6-px . Gebruik Composer om een patch op te geven. Als u bijvoorbeeld het pakket met Adobe Commerce 2.4.6-p1 wilt downloaden:

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

Bestandsmachtigingen instellen

U moet lees- en schrijfmachtigingen instellen voor de webservergroep voordat u Adobe Commerce installeert. Dit is nodig, zodat de opdrachtregel bestanden naar het bestandssysteem kan schrijven.

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

De toepassing installeren

U moet de opdrachtregel gebruiken om Adobe Commerce te installeren.

In dit voorbeeld wordt ervan uitgegaan dat de installatiemap de naam magento2ee heeft, db-host zich op dezelfde computer bevindt (localhost) en db-name , db-user en db-password alle magento zijn:

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
U kunt de Admin URI aanpassen met de optie --backend-frontname . Adobe raadt echter aan deze optie weg te laten en de installatieopdracht toe te staan automatisch een willekeurige URI te genereren. Willekeurige URI is moeilijker voor hakkers of kwaadwillige software om te exploiteren. De URI wordt in uw console weergegeven wanneer de installatie is voltooid.
TIP
Voor een volledige beschrijving van CLI installeert opties, zie de toepassing van de bevellijninstalleren.

Overzicht van Command

Als u een volledige lijst met opdrachten wilt weergeven, voert u in:

bin/magento list

Om hulp voor een bepaald bevel te krijgen, ga binnen:

bin/magento help <command>

Bijvoorbeeld:

bin/magento help setup:install
bin/magento help cache:enable

De volgende tabel geeft een overzicht van de beschikbare opdrachten. Opdrachten worden alleen in een samenvatting weergegeven. Voor meer informatie over een bevel, klik de verbinding in de kolom van het Bevel.

Opdracht
Beschrijving
Vereisten
magento setup:install
De toepassing installeren
Geen
magento setup:uninstall
Verwijdert de toepassing.
Toepassing geïnstalleerd
magento setup:upgrade
Werkt de toepassing bij.
Implementatieconfiguratie
magento maintenance:{enable/disable}
Schakelt de onderhoudsmodus in of uit (in de onderhoudsmodus hebben alleen vrijgestelde IP-adressen toegang tot Admin of storefront).
Toepassing geïnstalleerd
magento setup:config:set
Creeert of werkt de plaatsingsconfiguratie bij.
Geen
magento module:{enable/disable}
Modules in- of uitschakelen.
Geen
magento setup:store-config:set
Hiermee stelt u aan de winkel gerelateerde opties in, zoals basis-URL, taal en tijdzone.
Implementatieconfiguratie
magento setup:db-schema:upgrade
Werkt het databaseschema bij.
Implementatieconfiguratie
magento setup:db-data:upgrade
Werkt de databasegegevens bij.
Implementatieconfiguratie
magento setup:db:status
Controleert of de database up-to-date is met de code.
Implementatieconfiguratie
magento admin:user:create
Maakt een beheerdersgebruiker.
U kunt gebruikers voor het volgende tot stand brengen:

de configuratie van de Plaatsing

laat minstens toe Magento_User en Magento_Authorization modules

Gegevensbestand (de eenvoudigste manier is bin/magento setup:upgrade te gebruiken)
magento list
Hiermee geeft u alle beschikbare opdrachten weer.
Geen
magento help
Biedt hulp voor de opgegeven opdracht.
Geen

Algemene argumenten

De volgende argumenten gelden voor alle opdrachten. Deze opdrachten kunnen worden uitgevoerd vóór of nadat de toepassing is geïnstalleerd:

Lange versie
Korte versie
Betekenis
--help
-h
Krijg hulp voor om het even welk bevel. Bijvoorbeeld ./magento help setup:install of ./magento help setup:config:set .
--quiet
-q
Stille modus; geen uitvoer.
--no-interaction
-n
Geen interactieve vragen.
--verbose=1,2,3
-v, -vv, -vvv
Verbositeitsniveau. --verbose=3 of -vvv geeft bijvoorbeeld een uitgebreide foutopsporing weer. Dit is de meest uitgebreide uitvoer. De standaardwaarde is --verbose=1 of -v .
--version
-V
Deze toepassingsversie weergeven
--ansi
nvt
ANSI-uitvoer forceren
--no-ansi
nvt
ANSI-uitvoer uitschakelen
NOTE
Gefeliciteerd! U hebt de snelle installatie voltooid. Hebt u meer geavanceerde hulp nodig? Controle uit Geavanceerde installeertgids.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995