[僅限PaaS]{class="badge informative" title="僅適用於雲端專案(Adobe管理的PaaS基礎結構)和內部部署專案的Adobe Commerce 。"}

雲端專用變數

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
雲端
設定

建立對象：

開發人員

雲端基礎結構上Adobe Commerce專屬的環境變數使用MAGENTO_CLOUD_*前置詞：

變數

說明

MAGENTO_CLOUD_APP_DIR

應用程式目錄的絕對路徑。

MAGENTO_CLOUD_APPLICATION

說明應用程式的base64編碼JSON物件。它對應至.magento.app.yaml檔案內容並具有子索引鍵。

MAGENTO_CLOUD_APPLICATION_NAME

在.magento.app.yaml檔案中設定的應用程式名稱。

MAGENTO_CLOUD_DOCUMENT_ROOT

網頁主目錄的絕對路徑（如果適用）。

MAGENTO_CLOUD_ENVIRONMENT

環境分支的名稱。

MAGENTO_CLOUD_PROJECT

專案識別碼。

MAGENTO_CLOUD_RELATIONSHIPS

代表索引鍵（關係名稱）和值（關係配對陣列）端點定義的base64編碼JSON物件。每個關係端點定義都是URL的分解形式。它有scheme、host、port和 選擇性、username、password、path，以及query中的一些其他資訊。

MAGENTO_CLOUD_ROUTES

說明環境.magento/routes.yaml檔案中定義的路由。

MAGENTO_CLOUD_TREE_ID

應用程式的樹狀結構ID，對應至Git中樹狀結構的SHA。

MAGENTO_CLOUD_VARIABLES

具有索引鍵值配對的base64編碼JSON物件，例如"key":"value"。

MAGENTO_CLOUD_LOCKS_DIR

提供雲端基礎結構上鎖定提供者的掛載點路徑。鎖定提供者可防止啟動重複的cron作業和cron群組。

WARNING

若要使用Cloud Console將環境變數新增至覆寫組態設定，您必須在變數名稱前面加上env:，如下列範例所示：

由於值會隨著時間變更，因此最好在執行階段檢查變數，並使用它來設定應用程式。例如，使用MAGENTO_CLOUD_RELATIONSHIPS變數來擷取環境相關關係，如下所示：

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

檢視環境變數

您可以使用來自 ece-tools套件的env:config:show命令，顯示目前環境的變數清單。

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

variables選項的範例輸出：

Magento Cloud Environment Variables:
+-----------------------------------+----------------------------------+
| Variable name                     | Value                            |
+-----------------------------------+----------------------------------+
| ADMIN_EMAIL                       | commerceadmin@company.com        |
| ADMIN_PASSWORD                    | 123123q                          |
+-----------------------------------+----------------------------------+

recommendation-more-help

7c2b03ac-000c-497d-aba3-2c6dc720a938