Installare Adobe Commerce

Prima di iniziare, completa i passaggi seguenti:

NOTE
È necessario installare l'applicazione dalla relativa sottodirectory bin.

È possibile eseguire il programma di installazione più volte con diverse opzioni per completare attività di installazione come le seguenti:

  • Eseguire l'installazione in più fasi: ad esempio, dopo aver configurato il server Web per Secure Sockets Layer (SSL), è possibile eseguire di nuovo il programma di installazione per impostare le opzioni SSL.

  • Correggere gli errori nelle installazioni precedenti.

  • Installare l'applicazione in un'istanza di database diversa.

NOTE
Per impostazione predefinita, il programma di installazione non sovrascrive il database se si installa il software Commerce nella stessa istanza di database. È possibile utilizzare il parametro facoltativo cleanup-database per modificare questo comportamento.

Vedere anche Aggiorna, reinstalla, disinstalla.

Installazione sicura

Per utilizzare SSL (Secure Sockets Layer), noto anche come HTTPS, sia per l'amministratore che per lo storefront, è necessario impostare tutti i seguenti parametri:

  • --use-secure: imposta su 1
  • --base-url-secure: imposta su un URL protetto (cioè, che inizia con https://)
  • --use-secure-admin Imposta su 1

Ulteriori dettagli su questi parametri sono disponibili più avanti in questo argomento.

Comandi della Guida del programma di installazione

È possibile eseguire i seguenti comandi per trovare i valori per alcuni argomenti obbligatori:

Argomento del programma di installazione
Comando
Lingua
magento info:language:list
Valuta
magento info:currency:list
Fuso orario
magento info:timezone:list
NOTE
Se durante l'esecuzione di questi comandi viene visualizzato un errore, verificare di aver aggiornato le dipendenze di installazione come descritto in Aggiorna dipendenze di installazione.

Installa dalla riga di comando

Il comando install utilizza il seguente formato:

magento setup:install --<option>=<value> ... --<option>=<value>

Nelle tabelle seguenti vengono descritti i nomi e i valori delle opzioni di installazione, ad esempio i comandi di installazione. Vedi Esempi di installazioni localhost.

NOTE
Le opzioni contenenti spazi o caratteri speciali devono essere racchiuse tra virgolette singole o doppie.

Credenziali amministratore:

Le opzioni seguenti specificano le informazioni utente e le credenziali per l’utente amministratore.

In Adobe Commerce versione 2.2.8 e successive, puoi creare l’utente amministratore durante o dopo l’installazione. Se crei l’utente durante l’installazione, sono necessarie tutte le variabili delle credenziali amministratore. Vedi Esempi di installazioni localhost.

Nome
Valore
Obbligatorio
--admin-firstname
Nome dell'utente amministratore.
--admin-lastname
Cognome dell'utente amministratore.
--admin-email
Indirizzo di posta elettronica dell'utente amministratore.
--admin-user
Nome utente amministratore.
--admin-password
Password utente amministratore. La password deve contenere almeno 7 caratteri e includere almeno un carattere alfabetico e almeno un carattere numerico. Consigliamo una password più lunga e complessa. Racchiudere l'intera stringa della password tra virgolette singole. Ad esempio: --admin-password='A0b9%t3g'

Opzioni di configurazione del sito e del database:

Nome
Valore
Obbligatorio
--base-url
URL di base da utilizzare per accedere all'amministratore e alla vetrina in uno dei seguenti formati:

http[s]://<host or ip>/<your install dir>/.

Nota: lo schema (http:// o https://) e una barra finale sono entrambi obbligatori.

<your install dir> è il percorso relativo alla directory principale dei documenti in cui installare l'applicazione. A seconda della configurazione del server web e degli host virtuali, il percorso potrebbe essere magento2 o vuoto.

Per accedere all'applicazione su localhost, è possibile utilizzare http://127.0.0.1/<your install dir>/ o http://127.0.0.1/<your install dir>/.

- {{base_url}} che rappresenta un URL di base definito da un'impostazione host virtuale o da un ambiente di virtualizzazione come Docker. Ad esempio, se imposti un host virtuale con il nome host commerce.example.com, puoi installare l'applicazione con --base-url={{base_url}} e accedere all'amministratore con un URL come http://commerce.example.com/admin.
--backend-frontname
URI (Uniform Resource Identifier) per accedere all'amministratore. È possibile omettere questo parametro per consentire all'applicazione di generare un URI casuale con il seguente pattern admin_jkhgdfq.

È consigliabile utilizzare un URI casuale per motivi di sicurezza. Un URI casuale è più difficile da sfruttare per gli hacker o per il software dannoso.

L'URI viene visualizzato alla fine dell'installazione. È possibile visualizzarlo in un secondo momento utilizzando il comando magento info:adminuri.

Se scegli di immettere un valore, ti consigliamo di non usare una parola comune come admin, backend. L'URI amministratore può contenere solo valori alfanumerici e il carattere di sottolineatura (_).
No
--db-host
Utilizzare uno dei seguenti elementi:

- Nome host o indirizzo IP completo del server di database.

- localhost (impostazione predefinita) o 127.0.0.1 se il server di database si trova sullo stesso host del server Web.localhost significa che la libreria client MySQL utilizza socket UNIX per connettersi al database. 127.0.0.1 fa in modo che la libreria client utilizzi il protocollo TCP. Per ulteriori informazioni sui socket, consulta la documentazione PHP PDO_MYSQL.

Nota: è possibile specificare la porta del server di database nel nome host, ad esempio www.example.com:9000
--db-name
Nome dell'istanza di database in cui si desidera installare le tabelle di database.

Il valore predefinito è magento2.
--db-user
Nome utente del proprietario dell'istanza di database.

Il valore predefinito è root.
--db-password
Password del proprietario dell'istanza di database.
--db-prefix
Da utilizzare solo se si installano le tabelle di database in un'istanza di database in cui sono già presenti tabelle Adobe Commerce.

In tal caso, utilizzare un prefisso per identificare le tabelle per l'installazione. Alcuni clienti hanno più di un’istanza di Adobe Commerce in esecuzione su un server con tutte le tabelle nello stesso database.

La lunghezza del prefisso non può superare i cinque caratteri. Deve iniziare con una lettera e può includere solo lettere, numeri e caratteri di sottolineatura.

Questa opzione consente ai clienti di condividere il server di database con più installazioni.
No
--db-ssl-key
Percorso della chiave client.
No
--db-ssl-cert
Percorso del certificato client.
No
--db-ssl-ca
Percorso del certificato del server.
No
--language
Codice lingua da utilizzare nell’amministrazione e nella vetrina. Se non lo hai già fatto, puoi visualizzare l'elenco dei codici di lingua immettendo magento info:language:list dalla directory bin.
No
--currency
Valuta predefinita da utilizzare nella vetrina. Se non lo hai già fatto, puoi visualizzare l'elenco delle valute immettendo magento info:currency:list dalla directory bin.
No
--timezone
Fuso orario predefinito da utilizzare in Admin e storefront. Se non lo hai già fatto, puoi visualizzare l'elenco dei fusi orari immettendo magento info:timezone:list dalla directory bin.
No
--use-rewrites
1 significa che si utilizza il server Web per riscrivere i collegamenti generati nella vetrina e in Amministrazione.

0 disabilita l'utilizzo delle riscritture del server Web. Questa è l'impostazione predefinita.
No
--use-secure
1 consente l'utilizzo di Secure Sockets Layer (SSL) negli URL della vetrina. Prima di selezionare questa opzione, assicurati che il server web supporti SSL.

0 disabilita l'utilizzo di SSL. In questo caso, anche tutte le altre opzioni URL protetto sono impostate su 0. Questa è l'impostazione predefinita.
No
--base-url-secure
URL di base sicuro da utilizzare per accedere all'amministratore e alla vetrina nel seguente formato: http[s]://<host or ip>/<your install dir>/
No
--use-secure-admin
1 significa che si utilizza SSL per accedere all'amministratore. Prima di selezionare questa opzione, assicurati che il server web supporti SSL.

0 significa che non utilizzi SSL con l'amministratore. Questa è l'impostazione predefinita.
No
--admin-use-security-key
1 fa in modo che l’applicazione utilizzi un valore chiave generato in modo casuale per accedere alle pagine in Admin e nei moduli. Questi valori chiave aiutano a prevenire attacchi di tipo cross-site script forgery. Questa è l'impostazione predefinita.

0 disabilita l'utilizzo della chiave.
No
--session-save
Utilizzare uno dei seguenti elementi:

- db per archiviare i dati della sessione nel database. Se si dispone di un database in cluster, scegliere l'archiviazione del database. In caso contrario, l'archiviazione basata su file potrebbe non offrire molti vantaggi.

- files per archiviare i dati della sessione nel file system. L'archiviazione delle sessioni basata su file è appropriata a meno che l'accesso al file system non sia lento, che si disponga di un database cluster o che si desideri archiviare i dati della sessione in Redis.

- redis per archiviare i dati della sessione in Redis. Se utilizzi Redis per il caching predefinito o delle pagine, Redis deve essere già installato. Per ulteriori informazioni sulla configurazione del supporto per Redis, consulta Utilizzare Redis per l’archiviazione delle sessioni.
No
--key
Se disponibile, specificare una chiave per crittografare i dati sensibili nel database. Se non ne hai uno, l’applicazione ne genera uno per te.
--cleanup-database
Per eliminare le tabelle di database prima di installare l'applicazione, specificare questo parametro senza un valore. In caso contrario, il database viene lasciato intatto.
No
--db-init-statements
Parametro di configurazione MySQL avanzato. Utilizza le istruzioni di inizializzazione del database da eseguire durante la connessione al database MySQL. Consultate un riferimento simile a questo prima di impostare qualsiasi valore.

Il valore predefinito è SET NAMES utf8;.
No
--sales-order-increment-prefix
Specificare un valore stringa da utilizzare come prefisso per gli ordini cliente. In genere, viene utilizzato per garantire numeri di ordine univoci per gli elaboratori dei pagamenti.
No
TIP
Per abilitare i servizi di archiviazione remota durante l'installazione, vedere Configurare Archiviazione remota nella Guida alla configurazione.

Opzioni di configurazione del motore di ricerca:

Nome
Valore
Obbligatorio
--search-engine
Versione del motore di ricerca. I valori possibili sono elasticsearch7, elasticsearch6 e elasticsearch5. Il valore predefinito è elasticsearch7. Se OpenSearch è stato installato come motore di ricerca, specificare il valore elasticsearch7. L'Elasticsearch 5 è stato dichiarato obsoleto e non è consigliato.
No
--elasticsearch-host
Il nome host o l’indirizzo IP in cui è in esecuzione il motore di ricerca. Il valore predefinito è localhost.
No
--elasticsearch-port
Porta per le richieste HTTP in ingresso. Il valore predefinito è 9200.
No
--elasticsearch-index-prefix
Prefisso che identifica l'indice di ricerca. Il valore predefinito è magento2.
No
--elasticsearch-timeout
Il numero di secondi prima del timeout del sistema. Il valore predefinito è 15.
No
--elasticsearch-enable-auth
Abilita l'autenticazione sul server del motore di ricerca. Il valore predefinito è false.
No
--elasticsearch-username
ID utente da autenticare
No, a meno che l'autenticazione non sia abilitata
--elasticsearch-password
Password per l'autenticazione
No, a meno che l'autenticazione non sia abilitata

RabbitMQopzioni di configurazione:

Nome
Valore
Obbligatorio
--amqp-host
Non utilizzare le opzioni --amqp a meno che non sia già stata impostata un'installazione di RabbitMQ. Per ulteriori informazioni sull'installazione e la configurazione di RabbitMQ, vedere Installazione di RabbitMQ.

Il nome host in cui è installato RabbitMQ.
No
--amqp-port
Porta da utilizzare per la connessione a RabbitMQ. Il valore predefinito è 5672.
No
--amqp-user
Nome utente per la connessione a RabbitMQ. Non utilizzare l'utente predefinito guest.
No
--amqp-password
Password per la connessione a RabbitMQ. Non utilizzare la password predefinita guest.
No
--amqp-virtualhost
Host virtuale per la connessione a RabbitMQ. Il valore predefinito è /.
No
--amqp-ssl
Indica se connettersi a RabbitMQ. Il valore predefinito è false. Per informazioni sulla configurazione di SSL per RabbitMQ, vedere RabbitMQ.
No
--consumers-wait-for-messages
I consumatori devono attendere un messaggio dalla coda? 1 - Sì, 0 - No
No

Opzioni di archiviazione remota:

Nome
Descrizione
Obbligatorio
remote-storage-driver
Nome scheda
Valori possibili:
file: disabilita l'archiviazione remota e utilizza il file system locale
aws-s3: utilizza il servizio Amazon Simple Storage (Amazon S3)
No
remote-storage-bucket
Archiviazione oggetto o nome contenitore
No
remote-storage-prefix
Prefisso facoltativo (posizione all'interno dell'archivio oggetti)
No
remote-storage-region
Nome regione
No
remote-storage-key
Chiave di accesso opzionale
No
remote-storage-secret
Chiave segreta opzionale
No

Blocca opzioni di configurazione:

Nome
Valore
Obbligatorio
--lock-provider
Blocca nome provider.

Provider di blocchi disponibili: db, zookeeper, file.

Provider di blocchi predefinito: db
No
--lock-db-prefix
Prefisso db specifico per evitare conflitti di blocco quando si utilizza il provider di blocchi db.

Valore predefinito: NULL
No
--lock-zookeeper-host
Host e porta per la connessione al cluster Zookeeper quando si utilizza il provider di blocchi zookeeper.

Esempio: 127.0.0.1:2181
Sì, se si imposta --lock-provider=zookeeper
--lock-zookeeper-path
Percorso in cui Zookeeper salva i blocchi.

Percorso predefinito: /magento/locks
No
--lock-file-path
Percorso in cui vengono salvati i blocchi di file.
Sì, se si imposta --lock-provider=file

Opzioni di configurazione consumer:

Nome
Descrizione
Valore
Obbligatorio
--consumers-wait-for-messages
Determina se i consumatori attenderanno un messaggio dalla coda.
1 - Sì, 0 - No
No
  • 0: i consumer elaborano i messaggi disponibili nella coda, chiudono la connessione TCP e terminano. I consumatori non attendono messaggi aggiuntivi per entrare nella coda, anche se il numero di messaggi elaborati è inferiore al valore --max_messages specificato durante l'avvio dei consumatori.

  • 1: i consumer continuano a elaborare i messaggi dalla coda dei messaggi fino a raggiungere il numero massimo di messaggi (valore specificato per --max_messages nel comando queue:consumers:start) prima di chiudere la connessione TCP e terminare il processo consumer. Se la coda si svuota prima di raggiungere --max_messages, il consumatore attende l'arrivo di altri messaggi. Se si utilizzano i processi di lavoro per eseguire i consumer anziché un processo cron, impostare questa variabile su 1.

WARNING
L'opzione --consumers-wait-for-messages è globale e non può essere configurata separatamente per ogni consumatore.
NOTE
Per attivare o disattivare i moduli dopo l'installazione dell'applicazione, vedere Attivare e disattivare i moduli.

Dati sensibili:

Adobe Commerce utilizza la tua chiave di crittografia per crittografare quanto segue:

  • Informazioni carta di credito
  • Nomi utente e password specificati nella configurazione amministratore (ad esempio, accessi ai gateway di pagamento)
  • Valori CAPTCHA inviati tramite la rete

Adobe Commerce non crittografa:

  • Password e nomi utente amministrativi e cliente (con hash)
  • Indirizzo
  • Numero di telefono
  • Altri tipi di informazioni personali identificabili, ad eccezione dei numeri di carta di credito

Esempi di installazioni localhost

Gli esempi seguenti mostrano i comandi per installare Adobe Commerce localmente con varie opzioni.

Esempio 1: installazione di base con account utente amministratore

L'esempio seguente installa l'applicazione con le opzioni seguenti:

  • L'applicazione è installata nella directory magento2 relativa alla directory principale dei documenti del server Web in localhost e il percorso dell'amministratore è admin. Pertanto:

    L'URL della vetrina è http://127.0.0.1

  • Il server di database si trova sullo stesso host del server Web.

    Il nome del database è magento e il nome utente e la password sono entrambi magento

  • Utilizza le riscritture del server

  • L’amministratore dispone delle seguenti proprietà:

    • Il nome e il cognome sono Commerce User
    • Nome utente: admin, password: admin123
    • Indirizzo di posta elettronica: user@example.com
  • La lingua predefinita è en_US (inglese americano)

  • La valuta predefinita è il dollaro statunitense

  • Il fuso orario predefinito è Stati Uniti centrali (America/Chicago)

  • L'Elasticsearch 7 è installato su es-host.example.com e si connette alla porta 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=Commerce --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=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

Messaggi simili alla seguente visualizzazione per indicare un'installazione riuscita:

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

Esempio 2: installazione di base senza account utente amministratore

È possibile installare l'applicazione senza creare l'utente amministratore, come illustrato nell'esempio seguente.

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=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

Se l’installazione ha esito positivo, vengono visualizzati messaggi come i seguenti:

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

Dopo l'installazione è possibile creare un utente amministratore utilizzando il comando admin:user:create:
Creare o modificare un amministratore

Esempio 3 - Installazione con opzioni aggiuntive

L'esempio seguente installa l'applicazione con le opzioni seguenti:

  • Magapplication è installato nella directory magento2 relativa alla directory principale dei documenti del server Web in localhost e il percorso dell'amministratore è admin. Pertanto:

    L'URL della vetrina è http://127.0.0.1

  • Il server di database si trova sullo stesso host del server Web.

    Il nome del database è magento e il nome utente e la password sono entrambi magento

  • L’amministratore dispone delle seguenti proprietà:

    • Il nome e il cognome sono Commerce User
    • Nome utente: admin, password: admin123
    • Indirizzo di posta elettronica: user@example.com
  • La lingua predefinita è en_US (inglese americano)

  • La valuta predefinita è il dollaro statunitense

  • Il fuso orario predefinito è Stati Uniti centrali (America/Chicago)

  • Il programma di installazione pulisce il database prima di installare le tabelle e lo schema

  • Si utilizza un prefisso di incremento dell'ordine cliente ORD$ (poiché contiene un carattere speciale [$], il valore deve essere racchiuso tra virgolette)

  • I dati della sessione vengono salvati nel database

  • Utilizza le riscritture del server

  • L'Elasticsearch 7 è installato su es-host.example.com e si connette alla porta 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=Commerce --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=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200
NOTE
È necessario immettere il comando su una sola riga oppure, come nell'esempio precedente, con un carattere \ alla fine di ogni riga.

Se l’installazione ha esito positivo, vengono visualizzati messaggi come i seguenti:

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
TIP
Se disponi di un account utente per accedere al server applicazioni, vedi impostare un umask. Questo tipo di configurazione è tipico per l'hosting condiviso.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995