Documentazione Commerce Guida alla configurazione

Sostituisci impostazioni di configurazione

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Configurazione

Creato per:

Esperto
Amministratore
Sviluppatore

In questo argomento viene illustrato come derivare un nome di variabile d'ambiente conoscendo un percorso di configurazione. Puoi ignorare le impostazioni di configurazione di Adobe Systems Commerce utilizzando le variabili di ambiente. Ad esempio, puoi sovrascrivere il valore dell’URL live di un elaboratore di pagamenti sul sistema di produzione.

È possibile sovrascrivere il valore dell'impostazione di configurazione any utilizzando variabili di ambiente; tuttavia, l'Adobe consiglia di mantenere impostazioni coerenti utilizzando il file di configurazione condiviso, config.php, e il file di configurazione specifico del sistema, env.php, come descritto in Panoramica generale sulla distribuzione.

TIP

Consulta l'argomento Configurare gli ambienti nella guida di Commerce sull'infrastruttura cloud.

Variabili di ambiente

Un nome di variabile di ambiente è costituito dal relativo ambito seguito dal relativo percorso di configurazione in un particolare formato. Nelle sezioni seguenti viene illustrato come determinare un nome di variabile in modo più dettagliato.

È possibile utilizzare le variabili per uno dei seguenti elementi:

I valori sensibili devono essere impostati utilizzando le variabili di ambiente o il comando magento config:sensitive:set.
I valori specifici del sistema devono essere impostati utilizzando:
- Variabili di ambiente
- Il comando magento config:set
- L'amministratore seguito dal comando magento app:config:dump

I percorsi di configurazione si trovano in:

Variabile nomi

Di seguito è riportato il formato generale dei nomi delle variabili delle impostazioni di sistema:

<SCOPE>__<SYSTEM__VARIABLE__NAME>

<SCOPE> può essere:

ambito globale (ovvero l'impostazione globale per tutti gli ambiti)

Le variabili di ambito globali hanno il formato seguente:

CONFIG__DEFAULT__<SYSTEM__VARIABLE__NAME>
Un ambito specifico (ovvero, l'impostazione interessa solo una visualizzazione store o un sito Web specifici)

Le variabili dell’ambito della visualizzazione archivio, ad esempio, hanno il seguente formato:

CONFIG__STORES__ <STORE_VIEW_CODE>__<SYSTEM__VARIABLE__NAME>

Per ulteriori informazioni sugli ambiti, consulta:

<SYSTEM__VARIABLE__NAME> è il percorso di configurazione con due caratteri di sottolineatura al posto di /. Per ulteriori informazioni, vedere Passaggio 2: impostazione delle variabili di sistema.

Formato variabile

<SCOPE> è separato da <SYSTEM__VARIABLE__NAME> da due caratteri di sottolineatura.

<SYSTEM__VARIABLE__NAME> è derivato dal percorso di configurazione di un'impostazione di configurazione, che è una stringa delimitata da / che identifica in modo univoco un'impostazione specifica. Sostituire ogni carattere / nel percorso di configurazione con due caratteri di sottolineatura per creare la variabile di sistema.

Se un percorso di configurazione contiene un carattere di sottolineatura, questo rimane nella variabile.

Un elenco completo dei percorsi di configurazione è disponibile in:

Passaggio 1: trovare il valore di ambito della visualizzazione del sito Web o dello store

In questa sezione viene illustrato come trovare e impostare i valori di configurazione di sistema per ambito (visualizzazione archivio o sito Web). Per impostare le variabili di ambito globali, vedere Passaggio 2: Impostazione delle variabili di visualizzazione globali, del sito Web o dell'archivio.

I valori di ambito provengono dalle tabelle store, store_group e store_website.

La tabella store specifica i nomi e i codici della visualizzazione archivio
La tabella store_website specifica i nomi e i codici del sito Web

Puoi anche trovare i valori del codice utilizzando l’Admin.

Come leggere la tabella:

Colonna Path in Admin

I valori prima della virgola sono percorsi nella navigazione dell’amministratore. I valori dopo la virgola sono opzioni nel riquadro di destra.
La colonna Variable name è il nome della variabile di ambiente corrispondente.

È possibile specificare i valori di sistema per questi parametri di configurazione come variabili di ambiente, se lo si desidera.
- L'intero nome della variabile è sempre TUTTO MAIUSCOLO
- Inizia un nome variabile con CONFIG__ (notare due caratteri di sottolineatura)
- È possibile trovare il nome o <STORE_VIEW_CODE> <WEBSITE_CODE> parte di un nome di variabile nel database Admin o Commerce, come indicato nelle sezioni seguenti.
- <SYSTEM__VARIABLE__NAME> Come illustrato nel Passaggio 2: impostare variabili di visualizzazione globale, sito Web o store.

Trovare un ambito di visualizzazione sito web o store nell’Amministratore

Nella tabella seguente viene riepilogato come trovare il valore della visualizzazione del sito Web o dello store nell'amministratore.

Descrizione

Percorso in Admin

Variabile nome

Crea, modifica, elimina store visualizzazioni

Stores > All Stores

CONFIG__STORES__<STORE_VIEW_CODE>__<SYSTEM__VARIABLE__NAME>

Creazione, modifica ed eliminazione di siti Web

Stores > All Stores

CONFIG__WEBSITES__<WEBSITE_CODE>__<SYSTEM__VARIABLE__NAME>

Ad esempio, per trovare un valore di ambito di visualizzazione sito web o store nell’Admin:

Accedi all’amministratore come utente autorizzato a visualizzare i siti web.
Fare clic su Stores > All Stores.
Fai clic sul nome di una visualizzazione sito web o store.

Il riquadro di destra viene visualizzato in modo simile al seguente.
Il nome dell'ambito viene visualizzato nel campo Code.
Continua con Passaggio 2: imposta le variabili globali, di visualizzazione sito Web o di visualizzazione archivio.

Trovare un sito Web o visualizzare store ambito nel database

Per ottenere questi valori dal database:

Accedi al tuo sistema di sviluppo come file system proprietario se non lo hai già fatto.

Immetti il comando seguente:

code language-bash
`mysql -u <database-username> -p`

Al prompt mysql>, immettere i comandi seguenti nell'ordine indicato:

code language-shell
`use <database-name>;`

Utilizzare le query SQL seguenti per trovare i valori rilevanti:

code language-shell
`SELECT * FROM STORE; SELECT * FROM STORE_WEBSITE;`

Di seguito è riportato un esempio:

code language-shell

code language-shell
`mysql> SELECT * FROM STORE_WEBSITE; +------------+-------+--------------+------------+------------------+------------+ \| website_id \| code \| name \| sort_order \| default_group_id \| is_default \| +------------+-------+--------------+------------+------------------+------------+ \| 0 \| admin \| Admin \| 0 \| 0 \| 0 \| \| 1 \| base \| Main Website \| 0 \| 1 \| 1 \| \| 2 \| test1 \| Test Website \| 0 \| 3 \| 0 \| +------------+-------+--------------+------------+------------------+------------+`

mysql> SELECT * FROM STORE_WEBSITE;
+------------+-------+--------------+------------+------------------+------------+
| website_id | code  | name         | sort_order | default_group_id | is_default |
+------------+-------+--------------+------------+------------------+------------+
|          0 | admin | Admin        |          0 |                0 |          0 |
|          1 | base  | Main Website |          0 |                1 |          1 |
|          2 | test1 | Test Website |          0 |                3 |          0 |
+------------+-------+--------------+------------+------------------+------------+

Utilizza il valore della code colonna come nome del ambito, non come name valore.

Ad esempio, per impostare una variabile di configurazione per il sito Web di prova, utilizzare il formato seguente:

code language-shell
`CONFIG__WEBSITES__TEST1__<SYSTEM__VARIABLE__NAME>`

dove <SYSTEM__VARIABLE__NAME> viene dalla sezione successiva.

Passaggio 2: Imposta le variabili di visualizzazione globale, sito Web o store

Questa sezione illustra come impostare le variabili di sistema.

Per impostare i valori per l'ambito globale, ovvero tutti i siti Web, gli archivi e le visualizzazioni degli archivi, iniziare il nome della variabile con CONFIG__DEFAULT__.
Per impostare un valore per una particolare visualizzazione archivio o sito Web, avviare il nome della variabile come descritto in Passaggio 1: Trovare il valore dell'ambito:
- CONFIG__WEBSITES
- CONFIG__STORES
L’ultima parte del nome della variabile è il percorso di configurazione, univoco per ogni impostazione di configurazione.

Vedi alcuni esempi.

La tabella seguente mostra alcune variabili di esempio.

Descrizione

Percorso in Amministrazione (omettendo Archivi > Impostazioni > Configurazione)

Variabile nome

Elasticsearch nome host del server

Catalogo > Catalogo, Nome host server Elasticsearch

<SCOPE>__CATALOG__SEARCH__ELASTICSEARCH_SERVER_HOSTNAME

porta server Elasticsearch

Catalogo > Catalogo, Elasticsearch porta server

<SCOPE>__CATALOG__SEARCH__ELASTICSEARCH_SERVER_PORT

Paese di spedizione di provenienza

Vendita > spedizione Impostazioni

<SCOPE>__SHIPPING__ORIGIN__COUNTRY_ID

Custom Admin URL

Amministratore Avanzate >

<SCOPE>__ADMIN__URL__CUSTOM

Percorso amministratore personalizzato

Avanzate > Amministratore

<SCOPE>__ADMIN__URL__CUSTOM_PATH

Esempi

Questa sezione mostra come trovare i valori di alcune variabili di esempio.

Nome host del server Elasticsearch

Per trovare il nome della variabile per la minimizzazione globale di HTML:

Determinare l'ambito.

È l'ambito globale, quindi il nome della variabile inizia con CONFIG__DEFAULT__
Il resto del nome della variabile è CATALOG__SEARCH__ELASTICSEARCH_SERVER_HOSTNAME.

Risultato: nome variabile: CONFIG__DEFAULT__CATALOG__SEARCH__ELASTICSEARCH_SERVER_HOSTNAME

Origine paese di spedizione

Per trovare il nome della variabile per il paese di spedizione di origine:

Determinare il ambito.

Individuare il ambito nel database come illustrato nel Passaggio 1: trovare il sito Web o visualizzare store ambito valore. (È inoltre possibile trovare il valore nell'amministratore, come mostrato nella [tabella in Passaggio 2: Imposta variabili] di visualizzazione globale, sito Web o store (#step-2-set-global-website-or-store-view-variables.

Ad esempio, il ambito potrebbe essere CONFIG__WEBSITES__DEFAULT.
Il resto del nome della variabile è SHIPPING__ORIGIN__COUNTRY_ID.

Risultato: nome variabile: CONFIG__WEBSITES__DEFAULT__SHIPPING__ORIGIN__COUNTRY_ID

Come usare le variabili d'ambiente

Imposta i valori di configurazione come variabili utilizzando l'array associato di $_ENV PHP. È possibile impostare i valori in qualsiasi script PHP eseguito durante l'esecuzione di Commerce.

TIP

L'impostazione dei valori delle variabili in index.php o pub/index.php non funziona sempre come previsto poiché è possibile utilizzare diversi punti di ingresso applicazione a seconda della configurazione del server Web. Inserendo $_ENV le direttive nel app/bootstrap.php file, indipendentemente dai diversi punti di ingresso applicazione, le $_ENV direttive vengono sempre eseguite poiché il app/bootstrap.php file viene caricato come parte dell'architettura Commerce.

Di seguito è riportato un esempio di impostazione di due valori $_ENV:

$_ENV['CONFIG__DEFAULT__CATALOG__SEARCH__ELASTICSEARCH_SERVER_HOSTNAME'] = 'http://search.example.com';
$_ENV['CONFIG__DEFAULT__GENERAL__STORE_INFORMATION__MERCHANT_VAT_NUMBER'] = '1234';

Un esempio dettagliato viene visualizzato in Impostare i valori di configurazione utilizzando le variabili di ambiente.

WARNING

Per utilizzare i valori impostati nell'array $_ENV, è necessario impostare variables_order = "EGPCS"(Ambiente, Get, Post, Cookie e Server) nel file php.ini. Per informazioni dettagliate, vedere la documentazione PHP.
Per Adobe Commerce su infrastruttura cloud, se si tenta di ignorare le impostazioni di configurazione utilizzando Project Web Interface, è necessario anteporre al nome della variabile env:. Ad esempio:

recommendation-more-help

386822bd-e32c-40a8-81c2-ed90ad1e198c