설명서Commerce구성 안내서

구성 설정 재정의

Last update: Sat Nov 02 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 경험
  • 관리자
  • 개발자

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

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

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

환경 변수

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

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

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

변수 이름

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

<SCOPE>__<SYSTEM__VARIABLE__NAME>

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

<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 column은 해당 환경 변수 이름입니다.

    원할 경우 이러한 구성 매개변수에 대한 시스템 값을 환경 변수로 지정할 수 있습니다.

    • 전체 변수 이름은 항상 모두 대문자입니다.
    • 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>

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

  1. 웹 사이트를 볼 수 있는 권한이 있는 사용자로 관리자에 로그인합니다.

  2. Stores > All Stores ​을(를) 클릭합니다.

  3. 웹 사이트 또는 스토어 보기의 이름을 클릭합니다.

    오른쪽 창은 다음과 유사하게 표시됩니다.

    웹 사이트 코드 찾기

  4. Code 필드에 범위 이름이 표시됩니다.

  5. 2단계: 전역, 웹 사이트 또는 스토어 보기 변수를 설정합니다.

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

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

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

  2. 다음 명령을 입력합니다.

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

  3. 프롬프트에서 mysql> 다음 명령을 표시된 순서대로 입력합니다.

    code language-shell 
    use <database-name>;

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

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

    샘플은 다음과 같습니다.

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

  5. 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 축소를 위한 변수 이름을 찾으려면:

  1. 범위 결정.

    전역 범위이므로 변수 이름은 CONFIG__DEFAULT__

  2. 나머지 변수 이름은 입니다 CATALOG__SEARCH__ELASTICSEARCH_SERVER_HOSTNAME.

    결과: 변수 이름은 다음과 같습니다. CONFIG__DEFAULT__CATALOG__SEARCH__ELASTICSEARCH_SERVER_HOSTNAME

배송 국가 원산지

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

  1. 범위를 결정합니다.

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

    예를 들어 범위는 CONFIG__WEBSITES__DEFAULT일 수 있습니다.

  2. 나머지 변수 이름은 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"(환경, Get, Post, 쿠키 및 서버)을 설정해야 합니다. 자세한 내용은 PHP 설명서를 참조하세요.

  • 클라우드 인프라의 Adobe Commerce에서 Project Web Interface를 사용하여 구성 설정을 재정의하려는 경우 변수 이름 앞에 env:을(를) 추가해야 합니다. For example:

환경 변수 예
recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c