Adobe Commerce 2.4.0 릴리스 노트

관리자 계정, magento.com 사용자 계정 및 클라우드 SSH 액세스용 2FA 구현

• 관리자 계정 보안 설정. 이제 관리자에 2단계 인증(2FA)이 필요합니다. 관리자 사용자는 UI 또는 웹 API를 통해 관리자에 로그인하기 전에 먼저 2FA를 구성해야 합니다. 기본적으로 2FA가 활성화됩니다. 2FA 모듈을 비활성화하지 않는 것이 좋습니다. 이러한 추가 인증 단계를 수행하면 악의적인 사용자가 권한 부여 없이 관리자에 로그인하기 어려워집니다. 2단계 인증(2FA)을 참조하세요.

• 계정 보안 설정. 2단계 인증(2FA)은 원치 않는 방식으로 계정을 사용하려는 권한이 없는 사용자로부터 magento.com 계정을 더 잘 보호하기 위해 추가된 선택적 보안 계층을 제공합니다. 계정 보안을 참조하세요.

• 클라우드 SSH 액세스 보안. 클라우드 인프라의 Adobe은 클라우드 환경에 대한 SSH 액세스에 대한 인증 요구 사항을 관리하기 위한 MFA(Multi-Factor Authentication) 적용을 제공합니다. 프로젝트에서 2FA에 대한 다단계 인증이 기본적으로 활성화되어 있지 않습니다. Adobe은 이 기능을 활성화할 것을 강력히 권장합니다. 도움이 필요하면 지원팀에 문의하십시오. SSH 액세스를 위해 다단계 인증 사용을 참조하세요.

템플릿 필터 엄격 모드가 이제 기본적으로 사용됩니다. 레거시 모드에서 템플릿 필터를 사용하는 구성 요소(CMS 페이지 및 블록 포함)는 원격 코드 실행(RCE)에 취약할 수 있습니다. 기본적으로 엄격 모드를 활성화하면 RCE 공격을 의도적으로 활성화할 수 없습니다.

이제 UI 데이터 공급자에 대한 데이터 렌더링이 기본적으로 사용하지 않도록 설정됩니다. 이를 통해 악의적인 사용자가 임의의 JavaScript을 실행할 수 있는 기회를 제거할 수 있습니다.

새 \Magento\Framework\Escaper 클래스. 이 클래스는 HTML 생성을 담당하는 .phtml 템플릿과 PHP 클래스에 대해 제공됩니다. 이 클래스에는 여러 컨텍스트와 관련된 HTML 정리 메서드가 포함되어 있습니다. $escaper 로컬 변수는 .phtml 템플릿 내에서 사용할 수 있으며 더 이상 사용되지 않는 $block->escape{method} 대신 사용해야 합니다. $block->escape{method} 사용이 더 이상 사용되지 않으므로 $block이(가) 아닌 $escaper을(를) 사용하십시오.

security.txt 파일 지원. 이 파일은 보안 연구자가 사이트 관리자에게 잠재적인 보안 문제를 보고할 수 있도록 지원하는 서버의 업계 표준 파일입니다.

CSP(콘텐츠 보안 정책) 지원 개선 사항. SecureHtmlRenderer이(가) 프레임워크에 추가되었으며 .phtml 템플릿에서 인라인 style 및 script 태그를 화이트리스트에 추가할 수 있습니다. XML 파일로 재정의할 수 있는 기본 CSP 구성에서는 인라인 스크립트 및 스타일을 사용할 수 없습니다.

PHP 7.4 지원이 도입되고 PHP 7.1 및 7.2가 사용되지 않음. 2.4.0에서는 PHP 7.4에 대한 지원을 소개합니다.

PHPUnit 9.x 지원 및 PHPUnit 6.5 사용 중단. PHP 7.4에서는 최신 PHPUnit 테스트 프레임워크인 PHPUnit 9.x를 사용해야 합니다. Commerce Marketplace 확장 공급업체는 모든 새 확장 버전이 PHP 7.4와 호환되는지, 모든 장치 및 통합 테스트가 PHPUnit 9로 실행되도록 구성되었는지 확인해야 합니다.

Elasticsearch 7.6.x 지원. Elasticsearch 7.6.x는 이제 Adobe Commerce 및 Adobe Commerce의 기본 카탈로그 검색 엔진입니다. 버전 2.4.0을 설치하거나 업그레이드하려면 Elasticsearch 7.6.x도 설치해야 합니다. Elasticsearch 버전 2.x 코드가 제거되었습니다. Elasticsearch 버전 5.x 및 6.x는 더 이상 사용되지 않으며 더 이상 지원되지 않습니다. 검색 엔진 필수 구성 요소를 참조하십시오.

MySQL 8.0 지원. 버전 2.4.x는 MySQL 8.x를 지원합니다. (2.4.0은 MySQL 8.0.20으로 테스트되었습니다.) 판매자는 향상된 성능, 보안 및 안정성을 활용하기 위해 MySQL 8.x로 배포를 마이그레이션하는 것이 좋습니다. MySQL 5.7은 Magento 2.4.x에서 계속 지원되지만 MySQL 5.6은 더 이상 지원되지 않습니다. MySQL 5.6 데이터베이스에서는 2.4.x를 호스팅할 수 없습니다. MySQL을 참조하세요.

MariaDB 10.4 지원. MySQL 8.0 지원은 판매자가 Adobe Commerce과 함께 MariaDB 10.4를 배포할 수 있는 기회를 제공합니다. MariaDB 10.2와 2.4.0을 판매자가 계속 사용할 수 있지만 성능 및 안정성 향상을 위해 MariaDB 10.4로 업그레이드하는 것이 좋습니다. MariaDB 10.0 및 10.1은 더 이상 지원되지 않습니다(이 릴리스에서 MySQL 5.6에 대한 지원이 제거됨).

MySQL 카탈로그 검색 엔진 제거. MySQL 검색 엔진이 2.4.0에서 제거되고 Elasticsearch으로 기본 검색 엔진으로 대체되었습니다. Elasticsearch은 카탈로그 성능 최적화와 함께 뛰어난 검색 기능을 제공합니다. 모든 판매자에게 2.4.0을 설치하고 배포할 Elasticsearch이 있어야 합니다. Elasticsearch 설치 확인을 참조하세요.

Zend 프레임워크의 종속성을 Laminas 프로젝트(으)로 마이그레이션하여 Zend 프레임워크를 Linux Foundation의 Laminas 프로젝트로 전환하는 것을 반영합니다. Zend 프레임워크는 더 이상 사용되지 않습니다. Laminas 프로젝트에 대한 Zend 프레임워크의 마이그레이션 DevBlog 게시물을 참조하십시오.

컨트롤러 분해 ​을 통해 확장 개발자는 "레이어 슈퍼타입" 클래스 없이 ActionInterface를 직접 구현할 수 있습니다. 컨트롤러의 분해 DevBlog 게시물을 참조하십시오. 끌어오기 요청 16268에서 Vinai Kopp에 의해 시작되고 끌어오기 요청 26778 ​에서 Lukasz Bajsarowicz에 의해 완료된 개선 사항입니다. GitHub-9582

Signifyd 사기 방지 코드의 핵심 통합 제거. 이 핵심 기능은 더 이상 지원되지 않습니다. 판매자는 Commerce Marketplace에서 사용할 수 있는 Signifyd 사기 및 차지백 보호 확장(으)로 마이그레이션해야 합니다.

코어 Braintree 모듈이 코드베이스 ​에서 제거되었습니다. 이제 Braintree 결제 모듈에서 동일한 기능 세트를 제공합니다. 결제 Braintree을 참조하세요.

Internet Explorer 11.x 브라우저는 더 이상 지원되지 않습니다.

타사 결제 방법의 핵심 통합 제거. 이 릴리스에서는 Authorize.Net 결제 방법 통합이 코어 코드에서 제거되었습니다. 판매자는 Commerce Marketplace에서 사용할 수 있는 공식 확장으로 마이그레이션해야 합니다. 결제 통합 사용 중단 블로그 게시물을 참조하세요.

Elasticsearch에 대한 부분 단어 검색 지원(새 기본 검색 엔진). 이제 Elasticsearch은 빠른 검색을 사용할 때 제품 이름 및 SKU에 대한 검색어에서 부분 단어의 사용을 지원합니다. 이 기능은 MySQL 검색 엔진에서 지원되었으며, 이 엔진은 더 이상 사용되지 않으며 이 릴리스에서 Elasticsearch으로 대체되었습니다.

PayPal JavaScript SDK 업그레이드. PayPal Express Checkout 통합을 PayPal에 필요한 위험 매개 변수를 자동으로 수집하고 전달하는 SDK인 최신 PayPal JavaScript SDK로 마이그레이션했습니다. PayPal Express 체크아웃 결제 방법의 동작은 변경되지 않습니다. 그러나 이 SDK를 최신 버전으로 업그레이드하면 판매자가 최신 기능과 보안 개선 사항에 액세스할 수 있습니다.

웹 설정 마법사의 사용 중단 및 제거. 명령줄을 사용하여 2.4.0을 설치하거나 업그레이드해야 합니다. 설치 Magento을 참조하세요.

작성기 업데이트 플러그 인. 작성기 플러그인은 새 버전으로 업데이트하기 전에 루트 프로젝트 composer.json 파일에 적용해야 하는 변경 사항을 해결하여 업그레이드 프로세스를 간소화합니다. 이 플러그인은 사용자 지정 내용을 덮어쓰지 않도록 보호합니다. 작성기 루트 플러그인을 사용한 업그레이드를 참조하십시오.

판매자 지원 쇼핑. 이 기능을 사용하면 가맹점이 고객을 대신하여 상점을 볼 수 있습니다. 고객은 자신의 계정에 대한 상점 전면 액세스를 허용합니다. 이 커뮤니티 개발 기능에는 MAGEFAN에서 개발한 원본 확장이 포함되어 있습니다. 판매자 지원 쇼핑을 참조하세요. 기능은 다음과 같습니다.

• 고객 계정에 로그인할 수 있는 관리자를 제어하는 ACL은 웹 사이트별로 구성할 수 있습니다
• 여러 웹 사이트 및 고객 계정 범위와의 호환성
• 고객을 대신하여 수행한 주문은 상점 및 관리자에 기록됩니다
• 모든 세션은 관리자 로그아웃 후에 제거되며 관리자는 고객 암호에 액세스할 수 없습니다.

고객 데이터 섹션 무효화 로직에 대한 개선. 이 릴리스에서는 사용자 지정 sections.xml 무효화가 활성 상태일 때 로컬 저장소의 알려진 문제를 방지하는 모든 고객 섹션 데이터를 무효화하는 새로운 방법을 도입했습니다. (이전에는 작업이 무효화된 사용자 지정 etc/frontend/sections.xml ​이(가) 있는 경우 개인 콘텐츠(로컬 저장소)가 올바르게 채워지지 않았습니다.) 비공개 콘텐츠를 참조하세요.

Redis 성능에 대한 여러 최적화. 이 향상된 기능은 각 요청에 대해 수행되는 Redis에 대한 쿼리 수를 최소화합니다. 이러한 최적화에는 다음이 포함됩니다.

• Redis와 Magento 간의 네트워크 데이터 전송 크기 감소

• Redis의 CPU 사이클 소모량 감소: 어댑터의 로드 대상 자동 결정 기능 향상

• Redis 쓰기 작업에 대한 경합 조건 감소

페이지 및 기본 캐시에 Redis 사용 및 캐싱 구성을 참조하십시오.

인벤토리 테이블에 대한 SQL 쿼리 결과의 캐싱을 개선했습니다. 이러한 개선 사항은 다음과 같습니다.

• inventory_stock_sales_channel 테이블에 대한 SQL 쿼리 캐싱(16 대신 1개의 쿼리)

• 쿼리 결과를 inventory_stock 테이블에 캐싱(16 대신 1개의 쿼리)

빠른 주문 장바구니 추가 기능 성능으로 최대 25~30% 향상.

판매자는 이제 소극적 로드를 사용하여 이미지를 로드할 수 있습니다.

이제 Redis에 대한 연결이 중단되면 다음과 같은 동작이 표시됩니다. 이전에는 응용 프로그램이 현재 페이지를 다시 로드하지 않고 다음 오류를 표시했습니다. An error has happened during application run. See exception log for details.

• 관리자 및 상점 첫 번째 세션이 만료됩니다.
• 책임자 및 상점 첫 번째 사용자는 다시 로그인해야 합니다.
• 세션 데이터가 var/session/에 저장되었습니다.
• 오류나 예외가 기록되지 않습니다.

php bin/magento cron:run은(는) 더 이상 변경 로그 테이블의 항목을 여러 번 처리하지 않습니다. 이전에는 변경 로그 테이블에 새 버전이 100000개 이상 있으면 동일한 entity id에 대해 작업을 여러 번 호출할 수 있었습니다.

php bin/magento setup:cron:run 명령이 제거되었습니다. 또한 업그레이드 시 크론탭에서 이 파일에 대한 참조를 제거하십시오.

update/cron.php 파일이 2.4.0에서 제거되었습니다. 이 파일이 설치에 있으면 안전하게 제거할 수 있습니다. 또한 업그레이드 시 크론탭에서 이 파일에 대한 참조를 제거하십시오.

제품 쿼리에서 조각을 사용하는 동안 애플리케이션이 모든 필수 정보를 반환하지 않던 GraphQL 문제를 수정했습니다. 끌어오기 요청 26218 ​에서 Riccardo Tempesta가 제출한 수정 사항입니다. GitHub-26217

GraphQL 돌연변이 setShippingMethodsOnCart이(가) 더 이상 available_shipping_methods 특성에서 잘못된 데이터를 검색하지 않습니다. 끌어오기 요청 27004 ​에서 Vadim Malesh가 제출한 수정 사항입니다. GitHub-26742

드롭다운/다중 선택 상자에 모든 운송업체를 표시하는 대신 애플리케이션에 더 이상 빈 페이지가 표시되지 않습니다. 이전에는 vendor/magento/module-shipping/Model/Config/Source/Allmethods.php에서 toOptionArray 함수에 오류가 발생했습니다. 끌어오기 요청에서 Marc Rodriguez가 제출한 수정 사항 25315. GitHub-13136

고객이 여러 주소로 배송할 주문을 만들 때 애플리케이션에서 더 이상 고정 금액 할인을 여러 번 적용하지 않습니다. 끌어오기 요청 26419 ​에서 Mahesh Singh가 제출한 수정 사항입니다. GitHub-25834

테스트의 각 작업 그룹은 MFTF 모범 사례를 따르도록 별도의 파일로 이동되었으며 일치하지 않는 파일 이름이 수정되었습니다. 다음 모듈에 대한 테스트가 영향을 받았습니다.

• module-catalog-permissions
• 모듈 공유 카탈로그
• 모듈 카탈로그 이벤트
• 모듈 배너
• module-admin-gws
• module-advanced-checkout
• 모듈 배송
• module-ui
• 모듈 배송
• module-checkout-address-search
• 모듈 판매
• 모듈 카탈로그
• 모듈 카탈로그 규칙 스테이징
• module-visual-merchandiser
• 모듈-고객

끌어오기 요청 25800, 26323, 26321, 26320, 26319, 26322, 25828, 26329(및 개인 리포지토리 partners-magento2ee의 끌어오기 요청 104, 105, 106, 107, 108, 109, 111, 119, 120, 121)에서 Lukasz Bajsarowicz가 제출한 수정 사항. GitHub-22853

문제: 고객이 Amazon Pay로 체크아웃하는 동안 표준 체크아웃으로 돌아가기 ​를 클릭하면 결제 방법이 체크아웃 워크플로에서 누락됩니다. 해결 방법: 누락된 메서드를 표시하려면 체크아웃 페이지를 새로 고치십시오.

문제: 새 장바구니 가격 규칙을 만들 때 사용할 수 있는 결제 방법 드롭다운 목록에 두 개의 동일한 Amazon 결제 방법이 표시됩니다.

문제: 관리자가 Braintree 결산 보고서 페이지에 액세스하려고 하면 응용 프로그램에 오류가 표시됩니다(관리자 > 보고서). 현재 응용 프로그램에 An error has happened during application run. See exception log for details 메시지가 표시됩니다. Braintree 결제 보고서를 로드하지 못했습니다 기술 문서를 참조하십시오. 이 문제에 대한 BUNDLE-2683_SettlementReport.patch 핫픽스는 이제 릴리스에서 사용할 수 있습니다.

문제: 판매자는 Venmo가 사용되고 카드 결제에 대한 자격 증명 모음 사용 설정이 비활성화된 배포에서 주문에 대한 부분 송장을 만들 수 없습니다. 현재 응용 프로그램에 The "vault_capture" command doesn't exist. Verify the command and try again 오류가 표시됩니다.

문제: 새 장바구니 가격 규칙을 만들 때 사용할 수 있는 결제 방법 드롭다운 목록에 두 개의 동일한 PayPal 방법이 표시됩니다.

문제: 판매 > 가상 터미널 Braintree ​을 열 때 응용 프로그램에서 오류가 발생했습니다. 양식에 손상된 UI 요소가 포함되어 있지만 결제를 계속 허용합니다. 해결 방법: 올바른 Braintree 자격 증명을 저장하여 축소된 입력 필드를 수정합니다. 가상 터미널 Braintree 페이지가 손상되었습니다 기술 자료 문서를 참조하십시오. 이 문제에 대한 BUNDLE-2670_VirtualTerminal.patch 핫픽스는 이제 릴리스에서 사용할 수 있습니다.

문제: 고객이 체크아웃 중에 현지 결제 방법을 선택하면 벨기에, 네덜란드, 이탈리아, 스페인, 폴란드의 다음 국가에 오류 메시지가 표시됩니다. 해결 방법: 오류 메시지를 무시하고 결제를 계속합니다.

커뮤니티 회원이 이 릴리스에 대한 수정 사항을 제공한 경우 "커뮤니티 회원이 제공한 수정 사항" 구문을 사용하여 이 노트의 문제 해결 섹션에서 수정 사항을 확인합니다.

커뮤니티 엔지니어링 팀 Magento 참가자는 월별, 분기별, 연도별로 상위 기여 개인 및 파트너 목록을 유지 관리합니다. 해당 기여자 페이지에서 GitHub의 병합된 PR에 대한 링크를 따라갈 수 있습니다.