[PaaS만]{class="badge informative" title="Adobe Commerce 온 클라우드 프로젝트(Adobe 관리 PaaS 인프라) 및 온프레미스 프로젝트에만 적용됩니다."}

구성 설정 재정의

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
구성

작성 대상:

경험
관리자
개발자

이 항목에서는 구성 경로를 알고 있는 환경 변수 이름을 파생하는 방법에 대해 설명합니다. 환경 변수를 사용하여 Adobe Commerce 구성 설정을 재정의할 수 있습니다. 예를 들어 프로덕션 시스템에서 결제 프로세서의 라이브 URL 값을 재정의할 수 있습니다.

Adobe 환경 변수를 사용하여 any 구성 설정의 값을 재정의할 수 있습니다. 그러나 config.php배포 일반 개요env.php에 설명된 대로 공유 구성 파일 과(와) 시스템별 구성 파일을(를) 사용하여 일관된 설정을 유지하는 것이 좋습니다.

TIP

Commerce on Cloud Infrastructure 안내서의 환경 구성 항목을 확인하십시오.

환경 변수

환경 변수 이름은 범위 다음에 특정 형식의 구성 경로가 옵니다. 다음 섹션에서는 변수 이름을 결정하는 방법에 대해 자세히 설명합니다.

다음 중 하나에 변수를 사용할 수 있습니다.

중요한 값은(는) 환경 변수 또는 magento config:sensitive:set 명령을 사용하여 설정해야 합니다.
다음을 사용하여 시스템별 값을 설정해야 합니다.
- 환경 변수
- magento config:set 명령
- 관리자 다음에 magento app:config:dump 명령이 있음

구성 경로는 다음에서 찾을 수 있습니다.

변수 이름

시스템 설정 변수 이름의 일반적인 형식은 다음과 같습니다.

<SCOPE>__<SYSTEM__VARIABLE__NAME>

<SCOPE>은(는) 다음 중 하나일 수 있습니다.

전역 범위(즉, 모든 범위의 전역 설정)

전역 범위 변수의 형식은 다음과 같습니다.

CONFIG__DEFAULT__<SYSTEM__VARIABLE__NAME>
특정 범위(즉, 이 설정은 지정된 스토어 보기 또는 웹 사이트에만 영향을 줌)

예를 들어 스토어 뷰 범위 변수는 다음 형식을 갖습니다.

CONFIG__STORES__ <STORE_VIEW_CODE>__<SYSTEM__VARIABLE__NAME>

범위에 대한 자세한 내용은 다음을 참조하십시오.

<SYSTEM__VARIABLE__NAME>은(는) / 대신 이중 밑줄 문자가 있는 구성 경로입니다. 자세한 내용은 2단계: 시스템 변수 설정을 참조하십시오.

변수 형식

<SCOPE>은(는) <SYSTEM__VARIABLE__NAME>과(와) 밑줄 문자 두 개로 구분됩니다.

<SYSTEM__VARIABLE__NAME>은(는) 구성 설정의 구성 경로 에서 파생됩니다. 이 경로는 특정 설정을 고유하게 식별하는 / 구분 문자열로 구분됩니다. 구성 경로의 각 / 문자를 두 개의 밑줄 문자로 바꾸어 시스템 변수를 만듭니다.

구성 경로에 밑줄 문자가 포함되어 있으면 밑줄 문자가 변수에 남아 있습니다.

전체 구성 경로 목록은 다음 위치에서 찾을 수 있습니다.

1단계: 웹 사이트 또는 스토어 보기 범위 값 찾기

이 섹션에서는 범위(스토어 보기 또는 웹 사이트)별로 시스템 구성 값을 찾고 설정하는 방법에 대해 설명합니다. 전역 범위 변수를 설정하려면 2단계: 전역, 웹 사이트 또는 스토어 보기 변수 설정을 참조하십시오.

범위 값은 store, store_group 및 store_website 테이블에서 가져옵니다.

store 테이블은 저장소 보기 이름과 코드를 지정합니다.
store_website 테이블은 웹 사이트 이름과 코드를 지정합니다.

관리자를 사용하여 코드 값을 찾을 수도 있습니다.

표 읽기 방법:

Path in Admin 열

쉼표 앞의 값은 관리자 탐색의 경로입니다. 쉼표 뒤의 값은 오른쪽 창의 옵션입니다.
Variable name 열은 해당 환경 변수의 이름입니다.

원할 경우 이러한 구성 매개변수에 대한 시스템 값을 환경 변수로 지정할 수 있습니다.
- 전체 변수 이름은 항상 모두 대문자입니다.
- CONFIG__(으)로 변수 이름 시작(밑줄 문자 2개 참고)
- 다음 섹션에 표시된 대로 Admin 또는 Commerce 데이터베이스에서 변수 이름의 <STORE_VIEW_CODE> 또는 <WEBSITE_CODE> 부분을 찾을 수 있습니다.
- <SYSTEM__VARIABLE__NAME>2단계: 전역, 웹 사이트 또는 스토어 보기 변수 설정에서 설명한 대로을(를) 찾을 수 있습니다.

관리자에서 웹 사이트 또는 스토어 보기 범위 찾기

다음 표에는 관리자에서 웹 사이트를 찾거나 보기 값을 저장하는 방법이 요약되어 있습니다.

설명

관리자의 경로

변수 이름

스토어 조회수 생성, 편집, 삭제

Stores > All Stores

CONFIG__STORES__<STORE_VIEW_CODE>__<SYSTEM__VARIABLE__NAME>

웹 사이트 만들기, 편집, 삭제

Stores > All Store초

CONFIG__WEBSITES__<WEBSITE_CODE>__<SYSTEM__VARIABLE__NAME>

예를 들어, 관리자에서 웹 사이트를 찾거나 보기 범위 값을 저장하려면 다음을 수행합니다.

웹 사이트를 볼 수 있는 권한이 있는 사용자로 관리자에 로그인합니다.
Stores > All Stores 을(를) 클릭합니다.
웹 사이트 또는 스토어 보기의 이름을 클릭합니다.

오른쪽 창은 다음과 유사하게 표시됩니다.
Code 필드에 범위 이름이 표시됩니다.
2단계: 전역, 웹 사이트 또는 스토어 보기 변수를 설정합니다.

데이터베이스에서 웹 사이트 또는 스토어 보기 범위 찾기

데이터베이스에서 이러한 값을 가져오려면 다음을 수행합니다.

아직 로그인하지 않은 경우 개발 시스템에 파일 시스템 소유자로 로그인합니다.

다음 명령을 입력합니다.

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

mysql> 프롬프트에서 다음 명령을 표시된 순서대로 입력하십시오.

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

다음 SQL 쿼리를 사용하여 관련 값을 찾습니다.

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

샘플은 다음과 같습니다.

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

code 값이 아닌 name 열의 값을 범위 이름으로 사용합니다.

예를 들어 테스트 웹 사이트에 대한 구성 변수를 설정하려면 다음 형식을 사용하십시오.

code language-shell
`CONFIG__WEBSITES__TEST1__<SYSTEM__VARIABLE__NAME>`

여기서 <SYSTEM__VARIABLE__NAME>은(는) 다음 섹션에서 가져옵니다.

2단계: 글로벌, 웹 사이트 또는 스토어 보기 변수 설정

이 섹션에서는 시스템 변수를 설정하는 방법에 대해 설명합니다.

전역 범위(즉, 모든 웹 사이트, 스토어 및 스토어 보기 수)에 대한 값을 설정하려면 변수 이름을 CONFIG__DEFAULT__(으)로 시작합니다.
특정 스토어 보기 또는 웹 사이트에 대한 값을 설정하려면 1단계: 범위 값 찾기에서 설명한 대로 변수 이름을 시작하십시오.
- CONFIG__WEBSITES
- CONFIG__STORES
변수 이름의 마지막 부분은 각 구성 설정에 대해 고유한 구성 경로입니다.

몇 가지 예제를 참조하십시오.

다음 표는 몇 가지 샘플 변수를 보여 줍니다.

설명

관리자의 경로(스토어 > 설정 > 구성 생략)

변수 이름

Elasticsearch 서버 호스트 이름

카탈로그 > 카탈로그, Elasticsearch 서버 호스트 이름

<SCOPE>__CATALOG__SEARCH__ELASTICSEARCH_SERVER_HOSTNAME

Elasticsearch 서버 포트

카탈로그 > 카탈로그, Elasticsearch 서버 포트

<SCOPE>__CATALOG__SEARCH__ELASTICSEARCH_SERVER_PORT

배송 국가 원산지

판매 > 배송 설정

<SCOPE>__SHIPPING__ORIGIN__COUNTRY_ID

사용자 지정 관리자 URL

고급 > 관리자

<SCOPE>__ADMIN__URL__CUSTOM

사용자 지정 관리자 경로

고급 > 관리자

<SCOPE>__ADMIN__URL__CUSTOM_PATH

예

이 섹션에서는 일부 샘플 변수의 값을 찾는 방법을 보여줍니다.

Elasticsearch 서버 호스트 이름

글로벌 HTML 축소를 위한 변수 이름을 찾으려면 다음을 수행하십시오.

범위를 결정합니다.

전역 범위이므로 변수 이름이 CONFIG__DEFAULT__(으)로 시작합니다.
나머지 변수 이름은 CATALOG__SEARCH__ELASTICSEARCH_SERVER_HOSTNAME입니다.

결과: 변수 이름은 CONFIG__DEFAULT__CATALOG__SEARCH__ELASTICSEARCH_SERVER_HOSTNAME입니다.

배송 국가 원산지

운송 국가 출처의 변수 이름을 찾으려면

범위를 결정합니다.

1단계에서 설명한 대로 데이터베이스에서 범위를 찾습니다. 웹 사이트 또는 스토어 보기 범위 값을 찾습니다. (2단계: 전역, 웹 사이트 또는 스토어 보기 변수 설정[의 ]표에 표시된 대로 관리에서 값을 찾을 수도 #step-2-set-global-website-or-store-view-variables.

예를 들어 범위는 CONFIG__WEBSITES__DEFAULT일 수 있습니다.
나머지 변수 이름은 SHIPPING__ORIGIN__COUNTRY_ID입니다.

결과: 변수 이름은 CONFIG__WEBSITES__DEFAULT__SHIPPING__ORIGIN__COUNTRY_ID입니다.

환경 변수를 사용하는 방법

PHP의 $_ENV 연결 배열을 사용하여 구성 값을 변수로 설정합니다. Commerce이 실행될 때 실행되는 모든 PHP 스크립트에서 값을 설정할 수 있습니다.

TIP

웹 서버 구성에 따라 다른 응용 프로그램 진입점을 사용할 수 있으므로 index.php 또는 pub/index.php에서 변수 값을 설정하는 것이 항상 예상대로 작동하는 것은 아닙니다. 다른 응용 프로그램 시작 지점에 관계없이 $_ENV 지시문을 app/bootstrap.php 파일에 배치하면 $_ENV 파일이 Commerce 아키텍처의 일부로 로드되므로 app/bootstrap.php 지시문이 항상 실행됩니다.

두 개의 $_ENV 값을 설정하는 예는 다음과 같습니다.

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

환경 변수를 사용하여 구성 값 설정에 단계별 예제가 나와 있습니다.

WARNING

$_ENV 배열에서 설정한 값을 사용하려면 variables_order = "EGPCS" 파일에 php.ini(환경, Get, Post, 쿠키 및 서버)을 설정해야 합니다. 자세한 내용은 PHP 설명서를 참조하세요.
클라우드 인프라의 Adobe Commerce에서 Project Web Interface를 사용하여 구성 설정을 재정의하려는 경우 변수 이름 앞에 env:을(를) 추가해야 합니다. For example:

recommendation-more-help

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