[仅限PaaS]{class="badge informative" title="仅适用于云项目(Adobe管理的PaaS基础架构)和内部部署项目上的Adobe Commerce 。"}

特定于云的变量

Last update: Mon May 05 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

Web文档根目录的绝对路径（如果适用）。

MAGENTO_CLOUD_ENVIRONMENT

环境分支的名称。

MAGENTO_CLOUD_PROJECT

项目ID

MAGENTO_CLOUD_RELATIONSHIPS

表示键（关系名称）和值（关系对数组）端点定义的base64编码的JSON对象。每个关系端点定义是URL的一种分解形式。它在query中具有scheme、host、port和可选、username、password、path以及一些其他信息。

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