구성 설정 재정의

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
구성

작성 대상:

경험
관리자
개발자

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

환경 변수를 사용하여 any 구성 설정의 값을 재정의할 수 있습니다. 그러나 Adobe 일반 개요에서 설명한 대로 공유 구성 파일 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> 부분을 찾을 수 있습니다.
- 2단계: 전역, 웹 사이트 또는 스토어 보기 변수 설정에서 설명한 대로 <SYSTEM__VARIABLE__NAME>을(를) 찾을 수 있습니다.

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

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

설명

관리자의 경로

변수 이름

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

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

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

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

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 파일에 배치하면 app/bootstrap.php 파일이 Commerce 아키텍처의 일부로 로드되므로 $_ENV 지시문이 항상 실행됩니다.

두 개의 $_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 배열에서 설정한 값을 사용하려면 php.ini 파일에서 variables_order = "EGPCS"(Environment, Get, Post, Cookie 및 Server)을 설정해야 합니다. 자세한 내용은 PHP 설명서를 참조하세요.
클라우드 인프라의 Adobe Commerce에서 Project Web Interface를 사용하여 구성 설정을 재정의하려는 경우 변수 이름 앞에 env:을(를) 추가해야 합니다. For example:

recommendation-more-help

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