DocumentazioneCommerceGuida alla configurazione

Ignora impostazioni di configurazione

Last update: Mon Nov 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore

Questo argomento illustra come derivare il nome di una variabile di ambiente conoscendo un percorso di configurazione. Puoi sovrascrivere le impostazioni di configurazione di Adobe 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 le variabili di ambiente. Tuttavia, Adobe consiglia di mantenere le 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 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:

<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.

    Se lo desideri, puoi specificare i valori di sistema per questi parametri di configurazione come variabili di ambiente.

    • L'intero nome della variabile è sempre TUTTO MAIUSC
    • Iniziare un nome di variabile con CONFIG__ (annotare due caratteri di sottolineatura)
    • È possibile trovare la porzione <STORE_VIEW_CODE> o <WEBSITE_CODE> di un nome di variabile nel database Admin o Commerce, come indicato nelle sezioni seguenti.
    • È possibile trovare <SYSTEM__VARIABLE__NAME> come descritto in Passaggio 2: impostare variabili globali, di visualizzazione sito Web o di archiviazione.

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
Nome variabile
Creare, modificare ed eliminare le visualizzazioni dello store
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:

  1. Accedi all’amministratore come utente autorizzato a visualizzare i siti web.

  2. Fare clic su Stores > All Stores.

  3. Fai clic sul nome di una visualizzazione sito web o store.

    Il riquadro di destra viene visualizzato in modo simile al seguente.

    Trovare un codice sito Web

  4. Il nome dell'ambito viene visualizzato nel campo Code.

  5. 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:

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

  2. Immetti il comando seguente:

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

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

    code language-shell 
    use <database-name>;

  4. 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 
    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 |
+------------+-------+--------------+------------+------------------+------------+

  5. 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
URL amministratore personalizzato
Avanzate > Admin
<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:

  1. Determinare l'ambito.

    È l'ambito globale, quindi il nome della variabile inizia con CONFIG__DEFAULT__

  2. 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 l'origine del paese di spedizione:

  1. Determinare l'ambito.

    Trovare l'ambito nel database come descritto nel passaggio 1: Trovare il valore dell'ambito della visualizzazione del sito Web o dell'archivio. (Puoi anche trovare il valore nell'amministratore come mostrato nella tabella [del passaggio 2: Imposta variabili globali, di visualizzazione del sito Web o di archiviazione] (#step-2-set-global-website-or-store-view-variables.

    Ad esempio, l'ambito potrebbe essere CONFIG__WEBSITES__DEFAULT.

  2. Il resto del nome della variabile è SHIPPING__ORIGIN__COUNTRY_ID.

    Risultato: nome variabile: CONFIG__WEBSITES__DEFAULT__SHIPPING__ORIGIN__COUNTRY_ID

Come utilizzare le variabili di ambiente

Impostare i valori di configurazione come variabili utilizzando l'array associato $_ENV di PHP. È possibile impostare i valori in qualsiasi script PHP eseguito quando viene eseguito Commerce.

TIP
L'impostazione dei valori delle variabili in index.php o pub/index.php non funziona sempre come previsto, in quanto è possibile utilizzare punti di ingresso dell'applicazione diversi a seconda della configurazione del server Web. Inserendo $_ENV direttive nel file app/bootstrap.php, indipendentemente dai diversi punti di ingresso dell'applicazione, le direttive $_ENV vengono sempre eseguite dal caricamento del file app/bootstrap.php come parte dell'architettura di 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"(Environment, 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:

Esempio di variabile di ambiente
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c