Geavanceerde installatie op locatie
Command-lijn interface (CLI)
Adobe Commerce heeft één opdrachtregelinterface voor installatie- en configuratietaken: <magento_root>/bin/magento
. De interface voert veelvoudige taken uit, die omvatten:
- Installatie (en verwante taken zoals het creëren of bijwerken van het gegevensbestandschema, het creëren van de plaatsingsconfiguratie).
- De cache wissen.
- Indexen beheren, inclusief opnieuw indexeren.
- Vertaal- en vertaalwoordenboeken maken.
- Het produceren van niet-bestaande klassen zoals fabrieken en interceptors voor stop-ins, die de configuratie van de gebiedsinjectie voor de objecten manager produceren.
- Statische weergavebestanden gebruiken.
- CSS maken van minder.
Overige uitkeringen:
- Één enkel bevel (
<magento_root>/bin/magento list
) maakt een lijst van alle beschikbare installatie en configuratiebevelen. - Consistente gebruikersinterface gebaseerd op Symfony.
- CLI is verlengbaar zodat kunnen de derdeontwikkelaars "binnen"aan het "stoppen. Dit heeft het extra voordeel om de het leren kromme van gebruikers te elimineren.
- Opdrachten voor uitgeschakelde modules worden niet weergegeven.
Dit onderwerp bespreekt het installeren van de software van Adobe Commerce gebruikend CLI. Voor informatie over configuratie, zie de Gids van de Configuratie.
Het installatieprogramma kan indien nodig meerdere keren worden uitgevoerd, zodat u:
-
Verschillende waarden opgeven
Nadat u bijvoorbeeld uw webserver hebt geconfigureerd voor SSL (Secure Sockets Layer), kunt u het installatieprogramma uitvoeren om SSL-opties in te stellen.
-
Fouten in eerdere installaties corrigeren
-
Adobe Commerce in een andere database-instantie installeren
Voordat u de installatie start
Voer de volgende stappen uit voordat u begint:
-
Verifieer dat uw systeem aan de vereisten voldoet die in worden besproken systeemvereisten.
-
Voltooi alle voorwaardetaken.
-
Voer de eerste installatiestappen uit. Zie uw installeer of verbeteringspad.
-
Nadat u login aan de toepassingsserver, schakelaar aan de eigenaar van het dossiersysteem.
-
Herzie het snel begin van de installatieoverzicht.
bin
.U kunt het installatieprogramma meerdere keren uitvoeren met verschillende opties om installatietaken zoals de volgende uit te voeren:
-
Installeren in fasen — Nadat u bijvoorbeeld uw webserver hebt geconfigureerd voor SSL (Secure Sockets Layer), kunt u het installatieprogramma opnieuw uitvoeren om SSL-opties in te stellen.
-
Corrigeer fouten in eerdere installaties.
-
Installeer Adobe Commerce in een andere database-instantie.
cleanup-database
gebruiken om dit gedrag te wijzigen.Zie ook Update, herinstalleer, desinstalleer.
Beveiligde installatie
Als u SSL (Secure Sockets Layer) wilt gebruiken, ook wel HTTPS genoemd, voor zowel Admin als storefront, moet u alle volgende parameters instellen:
--use-secure
: Instellen op1
--base-url-secure
: Instellen op een beveiligde URL (te beginnen methttps://
)--use-secure-admin
Instellen op1
Meer details over deze parameters kunnen later in dit onderwerp worden gevonden.
Opdrachten voor Help bij de installateur
U kunt de volgende opdrachten uitvoeren om naar waarden voor bepaalde vereiste argumenten te zoeken:
bin/magento info:language:list
bin/magento info:currency:list
bin/magento info:timezone:list
Installeren vanaf de opdrachtregel
Voor de installatieopdracht wordt de volgende indeling gebruikt:
bin/magento setup:install --<option>=<value> ... --<option>=<value>
In de volgende tabellen worden de namen en waarden van de installatieopties beschreven. Bijvoorbeeld installatiebevelen, zie de installaties van de Steekproef localhost.
geloofsbrieven Admin:
Met de volgende opties geeft u de gebruikersgegevens en gebruikersgegevens voor de Admin-gebruiker op.
U kunt de Admin-gebruiker tijdens of na de installatie maken. Als u de gebruiker tijdens de installatie creeert, zijn alle admin credentievariabelen vereist. Zie installaties van de Steekproef localhost.
De volgende tabellen bevatten veel, maar niet alle beschikbare installatieparameters. Voor een volledige lijst, zie de bevel-lijn Verwijzing van Hulpmiddelen.
--admin-firstname
--admin-lastname
--admin-email
--admin-user
--admin-password
--admin-password='A0b9%t3g'
de configuratieopties van de Plaats en van het gegevensbestand:
--base-url
http[s]://<host or ip>/<your install dir>/
.Nota: de regeling (http:// of https://) en een het slepen schuine streep worden allebei vereist.
<your install dir>
is het documentafhankelijke relatieve pad voor de installatie van de Adobe Commerce-software. Afhankelijk van hoe u opstelling uw Webserver en virtuele gastheren, de weg magento2 zou kunnen zijn of het zou leeg kunnen zijn.om tot Adobe Commerce of tot MagenAdobe Commercieel toegang te hebben
http://127.0.0.1/<your install dir>/
of http://127.0.0.1/<your install dir>/
.-
{{base_url}}
die een basis-URL vertegenwoordigt die wordt gedefinieerd door een virtuele hostinstelling of door een virtualisatieomgeving zoals Docker. Als u bijvoorbeeld een virtuele host instelt met de hostnaam magento.example.com
, kunt u de software installeren met --base-url={{base_url}}
en toegang krijgen tot de beheerder met een URL zoals http://magento.example.com/admin
.--backend-frontname
te laten produceren admin_jkhgdfq
.wij adviseren willekeurige URI voor veiligheidsdoeleinden. Willekeurige URI is moeilijker voor hakkers of kwaadwillige software om te exploiteren.
de vertoningen van URI aan het eind van de installatie. U kunt deze later op elk gewenst moment weergeven met de opdracht
bin/magento info:adminuri
.als u verkiest om een waarde in te gaan, adviseren wij u geen gemeenschappelijk woord zoals admin, backend. De Admin-URI kan alleen alfanumerieke waarden en het onderstrepingsteken (
_
) bevatten.--db-host
- de volledig gekwalificeerde hostname van de gegevensbestandserver of IP adres.
-
localhost
(standaardwaarde) of 127.0.0.1
als uw databaseserver zich op dezelfde host bevindt als uw webserver.localhost betekent dat de MySQL-clientbibliotheek gebruikmaakt van UNIX-sockets om verbinding te maken met de database. 127.0.0.1
zorgt ervoor dat de clientbibliotheek het TCP-protocol gebruikt. Voor meer informatie over contactdozen, zie de PHP documentatie BOB_MYSQL.Nota: U kunt naar keuze de haven van de gegevensbestandserver in zijn hostname als www.example.com:9000 specificeren
--db-name
Standaard is
magento2
.--db-user
Standaard is
root
.--db-password
--db-prefix
In dat geval, gebruik een prefix om de lijsten voor deze installatie te identificeren. Sommige klanten hebben meer dan één Adobe Commerce of MagenAdobe Commerceserver met alle tabellen in dezelfde database.
de prefix kan een maximum van vijf karakters in lengte zijn. De naam moet met een letter beginnen en mag alleen letters, cijfers en onderstrepingstekens bevatten.
Deze optie laat die klanten toe om de gegevensbestandserver met meer dan één installatie van Adobe Commerce te delen
--db-ssl-key
--db-ssl-cert
--db-ssl-ca
--language
bin/magento info:language:list
in te voeren in de map bin.)--currency
bin/magento info:currency:list
in te voeren in de map bin.)--timezone
bin/magento info:timezone:list
in te voeren in de map bin/
.)--use-rewrites
1
betekent dat u herschrijvingen van webservers gebruikt voor gegenereerde koppelingen in de winkel en in Admin.0
schakelt het gebruik van herschrijven van webservers uit. Dit is de standaardinstelling.--use-secure
1
maakt het gebruik van SSL (Secure Sockets Layer) in winkel-URL's mogelijk. Zorg ervoor dat uw webserver SSL ondersteunt voordat u deze optie selecteert.0
schakelt het gebruik van SSL uit. In dit geval wordt aangenomen dat alle andere veilige URL-opties ook 0 zijn. Dit is de standaardinstelling.--base-url-secure
http[s]://<host or ip>/<your install dir>/
--use-secure-admin
1
betekent dat u SSL gebruikt om toegang te krijgen tot Admin. Zorg ervoor dat uw webserver SSL ondersteunt voordat u deze optie selecteert.0
betekent dat u geen SSL gebruikt met de Admin. Dit is de standaardinstelling.--admin-use-security-key
0
schakelt het gebruik van de toets uit.--session-save
-
db
om zittingsgegevens in het gegevensbestand op te slaan. Kies gegevensbestandopslag als u een gegroepeerd gegevensbestand hebt; anders, zou er niet veel voordeel over op dossier-gebaseerde opslag kunnen zijn.-
files
om sessiegegevens op te slaan in het bestandssysteem. De op dossier-gebaseerde zittingsopslag is aangewezen tenzij de toegang van het dossiersysteem langzaam is, hebt u een gegroepeerd gegevensbestand, of u wilt zittingsgegevens in Redis opslaan.-
redis
om sessiegegevens op te slaan in Redis. Als u Redis gebruikt als standaardinstelling of als u pagina's in cache plaatst, moet Redis al zijn geïnstalleerd. Zie Redis gebruiken voor sessieopslag voor aanvullende informatie over het configureren van ondersteuning voor Redis.--key
--cleanup-database
--db-init-statements
Standaard is
SET NAMES utf8;
.--sales-order-increment-prefix
de configuratieopties van de motor van het Onderzoek:
--search-engine
elasticsearch7
. Elasticsearch 5 is afgekeurd en wordt niet aanbevolen.--elasticsearch-host
localhost
.--elasticsearch-port
9200
.--elasticsearch-index-prefix
magento2
.--elasticsearch-timeout
15
.--elasticsearch-enable-auth
false
.--elasticsearch-username
--elasticsearch-password
--opensearch-host
localhost
.--opensearch-port
9200
.--opensearch-index-prefix
magento2
.--opensearch-timeout
15
.--opensearch-enable-auth
false
.--opensearch-username
--opensearch-password
RabbitMQconfiguratieopties:
--amqp-host
--amqp
alleen als u al een installatie van RabbitMQ hebt ingesteld. Zie RabbitMQ voor meer informatie over het installeren en configureren van RabbitMQ .hostname waar RabbitMQ geïnstalleerd is.
--amqp-port
--amqp-user
guest
niet.--amqp-password
guest
.--amqp-virtualhost
/
.--amqp-ssl
false
. Zie RabbitMQ voor informatie over het instellen van SSL voor RabbitMQ .--consumers-wait-for-messages
de configuratieopties van het Slot:
--lock-provider
Beschikbare vergrendelingsproviders:
db
, zookeeper
, file
.De standaardvergrendelingsprovider:
db
--lock-db-prefix
db
vergrendelingsprovider gebruikt.De standaardwaarde:
NULL
--lock-zookeeper-host
zookeeper
lock provider gebruikt.Bijvoorbeeld:
127.0.0.1:2181
--lock-provider=zookeeper
instelt--lock-zookeeper-path
Het standaardpad is:
/magento/locks
--lock-file-path
--lock-provider=file
insteltde configuratieopties van de Consumenten:
--consumers-wait-for-messages
-
0
: De consumenten verwerken beschikbare berichten in de rij, sluiten de verbinding van TCP, en eindigen. De consumenten wachten niet op extra berichten om de rij in te gaan, zelfs als het aantal verwerkte berichten minder dan de--max_messages
waarde is die tijdens beginnende consumenten wordt gespecificeerd. -
1
: De consumenten blijven berichten van de berichtrij verwerken tot het maximum aantal berichten (de waarde die voor--max_messages
op hetqueue:consumers:start
bevel wordt gespecificeerd) alvorens de verbinding van TCP te sluiten en het consumentenproces te beëindigen. Als de wachtrij leeg is voordat--max_messages
wordt bereikt, wacht de consument tot er meer berichten zijn. Als u workers gebruikt om consumenten te runnen in plaats van een uitsnijdtaak, stelt u deze variabele in op1
.
--consumers-wait-for-messages
is een algemene optie en kan niet afzonderlijk voor elke consument worden geconfigureerd.Gevoelige gegevens:
Adobe Commerce gebruikt uw coderingssleutel om het volgende te coderen:
- Creditcardgegevens
- Gebruikersnamen en wachtwoorden die zijn opgegeven in de beheerconfiguratie (bijvoorbeeld aanmelden bij betaalgateways)
- CAPTCHA-waarden die via het netwerk worden verzonden
Adobe Commerce ** coderen niet:
- Administratieve en klantengebruikersnamen en wachtwoorden (deze wachtwoorden worden gehakt)
- Adres
- Telefoonnummer
- Andere soorten persoonlijk identificeerbare informatie, behalve creditcardnummers
Voorbeeld van localhost-installaties
In de volgende voorbeelden ziet u de opdrachten voor het lokaal installeren van Adobe Commerce met verschillende opties.
Voorbeeld 1—Basisinstallatie met beheergebruikersaccount
In het volgende voorbeeld wordt Adobe Commerce geïnstalleerd met de volgende opties:
-
De toepassing wordt geïnstalleerd in de map
magento2
ten opzichte van de hoofdmap van de webserver oplocalhost
en het pad naar de beheerdersmap isadmin
. Dit betekent dat:De URL van uw winkel is
http://127.0.0.1
-
De databaseserver bevindt zich op dezelfde host als de webserver.
De databasenaam is
magento
en de gebruikersnaam en het wachtwoord zijn beidemagento
-
Gebruikt herschrijvingen van server
-
De beheerder heeft de volgende eigenschappen:
- Voornaam en achternaam zijn
Magento User
- Gebruikersnaam is
admin
en het wachtwoord isadmin123
- E-mailadres is
user@example.com
- Voornaam en achternaam zijn
-
Standaardtaal is
en_US
(Amerikaans Engels) -
Standaardvaluta is Amerikaanse dollars
-
Standaardtijdzone is VS Central (Amerika/Chicago)
-
OpenSearch 1.2 is geïnstalleerd op
os-host.example.com
en maakt verbinding op poort 9200
magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Magento --admin-lastname=User --admin-email=user@example.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
Berichten die lijken op de volgende weergave om aan te geven dat de installatie is gelukt:
Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q
Voorbeeld 2— Basisinstallatie zonder beheergebruikersaccount
U kunt Adobe Commerce installeren zonder de beheerdersgebruiker te maken, zoals in het volgende voorbeeld wordt getoond.
magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
Berichten zoals de volgende weergave als de installatie is gelukt:
Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q
Na de installatie kunt u een beheerder maken met de opdracht admin:user:create
:
creeer of geef een beheerderuit
Voorbeeld 3—Installeren met extra opties
In het volgende voorbeeld wordt Adobe Commerce geïnstalleerd met de volgende opties:
-
De toepassing wordt geïnstalleerd in de map
magento2
ten opzichte van de hoofdmap van de webserver oplocalhost
en het pad naar de beheerdersmap isadmin
. Dit betekent dat:De URL van uw winkel is
http://127.0.0.1
-
De databaseserver bevindt zich op dezelfde host als de webserver.
De databasenaam is
magento
en de gebruikersnaam en het wachtwoord zijn beidemagento
-
De beheerder heeft de volgende eigenschappen:
- Voornaam en achternaam zijn
Magento User
- Gebruikersnaam is
admin
en het wachtwoord isadmin123
- E-mailadres is
user@example.com
- Voornaam en achternaam zijn
-
Standaardtaal is
en_US
(Amerikaans Engels) -
Standaardvaluta is Amerikaanse dollars
-
Standaardtijdzone is VS Central (Amerika/Chicago)
-
Het installatieprogramma schoont eerst de database voordat de tabellen en het schema worden geïnstalleerd
-
U kunt het voorvoegsel voor de verhoging van de verkooporder gebruiken
ORD$
(omdat het een speciaal teken [$
] bevat, moet de waarde tussen dubbele aanhalingstekens staan) -
Sessiegegevens worden opgeslagen in de database
-
Gebruikt herschrijvingen van server
-
OpenSearch is geïnstalleerd op
os-host.example.com
en maakt verbinding op poort 9200
magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Magento --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --cleanup-database \
--sales-order-increment-prefix="ORD$" --session-save=db --use-rewrites=1 \
--search-engine=opensearch --opensearch-host=os-host.example.com \
--opensearch-port=9200
\
-teken aan het einde van elke regel.Berichten zoals de volgende weergave als de installatie is gelukt:
Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q