Snelle start van de installatie op locatie

In de instructies op deze pagina wordt beschreven hoe u Adobe Commerce kunt installeren op zelfgehoopt infrastructuur. Raadpleeg voor hulp bij het upgraden van een bestaande installatie de Upgradehandleiding.

Adobe gebruikt Composer om Adobe Commerce-componenten en hun afhankelijkheden 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 to PHP-Framework Interoperability Group (FIG) normen
  • Magento Open Source opnieuw verpakken met andere componenten
  • De Adobe Commerce-software gebruiken in een productieomgeving
NOTE
Ontwikkelaars die bijdragen aan de Magento Open Source moeten de op basis van git installatiemethode.

Vereisten

Voordat u verdergaat, moet u het volgende doen:

Aanmelden als eigenaar van bestandssysteem

Meer informatie over eigendom, machtigingen en de eigenaar van het bestandssysteem in de Overzicht van het onderwerp eigendom en machtigingen.

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. Om CLI bevelen van om het even welke folder in werking te stellen, voeg toe <app_root>/bin op uw systeem PATH.

    Omdat schelpen verschillende syntaxis hebben, raadpleegt u een verwijzing zoals 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 uitvoeren als ./magento <command name>
    • 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. Meld u aan bij de toepassingsserver als of schakel over naar de eigenaar van bestandssysteem.

  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 gevormd Commerce Marketplace.

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

    Als u fouten tegenkomt, zoals Could not find package... of ...no matching package found, zorg ervoor dat er geen typos in uw bevel zijn. Als er nog steeds fouten optreden, kunt u geen Adobe Commerce downloaden. Contact Adobe Commerce-ondersteuning voor hulp.

    Zie Problemen oplossen voor 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

Kwaliteitspatches bevatten voornamelijk functionele en beveiligingsoplossingen. 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 gebruiken 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 naam van de installatiemap is magento2eede db-host bevindt zich op dezelfde computer (localhosten dat de db-name, db-user, en db-password zijn allen 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
U kunt de Admin URI aanpassen met de --backend-frontname -optie. 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
Zie voor een volledige beschrijving van de CLI-installatieopties De toepassing installeren vanaf de opdrachtregel.

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 maken voor het volgende:

Implementatieconfiguratie

minimaal inschakelen Magento_User en Magento_Authorization modules

Database (de eenvoudigste manier is om te gebruiken) bin/magento setup:upgrade)
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. Bijvoorbeeld: --verbose=3 of -vvv vertoningen zuiveren breedtegraad, die de breedste output is. Standaard 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? Kijk uit de Geavanceerde installatie hulplijn.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995