DocumentazioneCommerceGuida di Commerce sul cloud

[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe) e ai progetti on-premise."}

Variabili specifiche per il cloud

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Sviluppatore

Le variabili di ambiente specifiche di Adobe Commerce sull'infrastruttura cloud utilizzano il prefisso MAGENTO_CLOUD_*:

Variabile
Descrizione
MAGENTO_CLOUD_APP_DIR
Percorso assoluto della directory dell'applicazione.
MAGENTO_CLOUD_APPLICATION
Oggetto JSON con codifica base64 che descrive l’applicazione. È mappato al contenuto del file .magento.app.yaml e dispone di sottochiavi.
MAGENTO_CLOUD_APPLICATION_NAME
Il nome dell'applicazione configurata nel file .magento.app.yaml.
MAGENTO_CLOUD_DOCUMENT_ROOT
Percorso assoluto della directory principale del documento web, se applicabile.
MAGENTO_CLOUD_ENVIRONMENT
Nome del ramo dell’ambiente.
MAGENTO_CLOUD_PROJECT
ID del progetto.
MAGENTO_CLOUD_RELATIONSHIPS
Oggetto JSON con codifica base64 che rappresenta la definizione dell’endpoint chiave (nome della relazione) e valore (matrici di coppie di relazioni). Ogni definizione di endpoint di relazione è una forma scomposta di un URL. Contiene scheme, host, port e facoltativamente a username, password, path e alcune informazioni aggiuntive in query.
MAGENTO_CLOUD_ROUTES
Descrivere le route definite nel file di ambiente .magento/routes.yaml.
MAGENTO_CLOUD_TREE_ID
L’ID della struttura per l’applicazione, che corrisponde all’SHA della struttura in Git.
MAGENTO_CLOUD_VARIABLES
Oggetto JSON con codifica base64 con coppie chiave-valore, ad esempio "key":"value".
MAGENTO_CLOUD_LOCKS_DIR
Fornisce il percorso del punto di montaggio per il provider di blocchi nell’infrastruttura cloud. Il provider di blocchi impedisce l'avvio di processi cron e gruppi cron duplicati.
WARNING
Per aggiungere variabili di ambiente a sostituire le impostazioni di configurazione utilizzando Cloud Console, è necessario anteporre al nome della variabile env: come nell'esempio seguente:
Esempio di variabile di ambiente

Poiché i valori possono cambiare nel tempo, è consigliabile esaminare la variabile in fase di esecuzione e utilizzarla per configurare l’applicazione. Ad esempio, utilizzare la variabile MAGENTO_CLOUD_RELATIONSHIPS per recuperare le relazioni relative all'ambiente nel modo seguente:

<?php
/**
  * Get relationships information from cloud environment variable.
  *
  * @return mixed
  */
    protected function getRelationships()
    {
        return json_decode(base64_decode($_ENV["MAGENTO_CLOUD_RELATIONSHIPS"]), true);
    }

Visualizzazione delle variabili di ambiente

È possibile utilizzare il comando env:config:show da il pacchetto ece-tools per visualizzare un elenco di variabili per l'ambiente corrente.

php ./vendor/bin/ece-tools env:config:show variables

Output di esempio per l'opzione variables:

Magento Cloud Environment Variables:
+-----------------------------------+----------------------------------+
| Variable name                     | Value                            |
+-----------------------------------+----------------------------------+
| ADMIN_EMAIL                       | commerceadmin@company.com        |
| ADMIN_PASSWORD                    | 123123q                          |
+-----------------------------------+----------------------------------+
recommendation-more-help
7c2b03ac-000c-497d-aba3-2c6dc720a938