설명서Commerce업그레이드 안내서

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

패치 적용

Last update: Wed Sep 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 경험
  • 관리자
  • 개발자

다음 방법 중 하나를 사용하여 패치를 적용할 수 있습니다.

TIP
엔터프라이즈 규모의 Adobe Commerce에 대한 중앙 집중식 패치에 대한 자세한 내용은 모범 사례를 참조하세요.

작성기

IMPORTANT
Adobe은 이 방법을 사용하여 Adobe에서 제공하는 공식 패치를 적용할 수 없습니다. 다음의 방법을 사용하십시오. 공식 패치를 적용하려면 Quality Patches Tool을(를) 사용합니다. 사용자 정의 패치를 배포하기 전에 항상 포괄적인 테스트를 수행하십시오.

작성기를 사용하여 사용자 정의 패치를 적용하려면 다음을 수행합니다.

  1. 명령줄 응용 프로그램을 열고 프로젝트 디렉터리로 이동합니다.

  2. cweagans/composer-patches 플러그인을 composer.json 파일에 추가합니다.

    code language-bash 
    composer require cweagans/composer-patches

  3. composer.json 파일을 편집하고 다음 섹션을 추가하여 지정하십시오.

    • 모듈: "magento/module-payment"
    • 제목: "MAGETWO-56934: 잘못된 신용 카드로 Authorize.net을 사용하여 주문할 때 체크아웃 페이지가 중지됩니다"
    • 패치 경로: "patches/composer/github-issue-6474.diff"

    For example:

    code language-json 
    "extra": {
    "composer-exit-on-patch-failure": true,
    "patches": {
        "magento/module-payment": {
            "MAGETWO-56934: Checkout page freezes when ordering with Authorize.net with invalid credit card": "patches/composer/github-issue-6474.diff"
        }
    }
}

    패치가 여러 모듈에 영향을 주는 경우 여러 모듈을 대상으로 하는 여러 패치 파일을 만들어야 합니다.

  4. 패치를 적용합니다. 디버깅 정보를 보려면 -v 옵션을 사용하십시오.

    code language-bash 
    composer -v install

  5. composer.lock 파일을 업데이트합니다. 잠금 파일은 개체의 각 Composer 패키지에 적용된 패치를 추적합니다.

    code language-bash 
    composer update --lock

명령줄

명령줄에서 패치를 적용하려면 다음을 수행합니다.

  1. FTP, SFTP, SSH 또는 일반적인 전송 방법을 사용하여 서버의 <Magento_root> 디렉터리에 로컬 파일을 업로드합니다.

  2. 서버에 admin user(으)로 로그인하고 파일이 올바른 디렉터리에 있는지 확인하십시오.

  3. 명령줄 인터페이스에서 패치 확장에 따라 다음 명령을 실행합니다.

    code language-bash 
    patch < patch_file_name.patch

    이 명령은 패치할 파일이 패치 파일을 기준으로 있다고 가정합니다.

    note note
    NOTE
    명령줄에 File to patch:이(가) 표시되면 경로가 올바른 것 같더라도 의도한 파일을 찾을 수 없다는 의미입니다. 명령줄 터미널에 표시된 상자에서 첫 번째 줄에 패치할 파일이 표시됩니다. 파일 경로를 복사하여 File to patch: 프롬프트에 붙여 넣고 Enter을(를) 누르면 패치가 완료됩니다.

  4. 변경 사항을 반영하려면 시스템 > 도구 > 캐시 관리 ​에서 관리자의 캐시를 새로 고치십시오.

    또는 동일한 명령으로 패치를 로컬에 적용한 다음 커밋하고 정상적으로 푸시할 수 있습니다.

recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea