오류 메시지 Upgrade Compatibility Tool개
이 오류 메시지 참조는 Upgrade Compatibility Tool 실행 중에 발생할 수 있는 오류에 대한 정보를 제공합니다.
오류 메시지는 수준(심각한 문제, 오류 및 경고)과 유형(코어 코드, 사용자 지정 코드 및 GraphQL 스키마)별로 분류됩니다. 각 유형에는 다음 정보가 포함됩니다.
- 오류 코드: Adobe Commerce에서 오류 메시지에 대한 식별자를 할당했습니다.
- 오류 설명: 오류의 원인을 요약하는 설명입니다.
- 오류 제안 작업: 해당되는 경우 오류를 해결하고 해결하기 위한 지침을 제공합니다.
중요한 문제
코어 코드
이러한 오류는 코어 파일 중 일부가 없거나 원본과 일치하지 않을 때 보고됩니다.
composer install
명령을 실행합니다.composer install
명령을 실행합니다.composer require package_name
을(를) 실행하여 종속성을 복원합니다.composer install
명령을 실행합니다.사용자 지정 코드
사용자 지정 코드가 대상 Adobe Commerce 버전에 없는 엔티티를 참조할 때 중대 오류가 발생합니다. 이러한 오류는 중요한 코딩 표준이 손상되었을 때도 보고됩니다.
@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다. 존재하지 않는 Adobe Commerce 클래스/인터페이스를 인스턴스화합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다. 단일 클래스 내에서만 사용할 수 있는 경우 속성 액세스 수준을 전용으로 업데이트합니다.DB 스키마
제거된 핵심 테이블 또는 열을 사용자 지정 제약 조건에서 참조하는 경우 DB 스키마 심각한 문제가 보고됩니다.
GraphQL 스키마
스키마 항목이 대상 버전에 없으면 GraphQL 스키마 위험 문제가 발생합니다.
오류수
사용자 지정 코드
사용자 지정 코드에서 @api
(으)로 간주되거나 표시되지 않는 Adobe Commerce 진입점을 사용할 때 사용자 지정 코드 오류가 발생합니다. 그러한 진입점의 보존적 행동은 보장되지 않는다. 사용자 지정은 @api
진입점을 대신 사용해야 합니다. 비 API Adobe Commerce 코드를 기반으로 하는 기능은 업그레이드 후 테스트해야 합니다. 이러한 오류는 주요 코딩 표준이 깨졌을 때도 보고된다.
@api
(으)로 표시되지 않은 클래스는 변경될 수 있습니다. 대신 @api
(으)로 표시된 인터페이스를 사용하도록 코드를 업데이트하는 것이 좋습니다. 그렇지 않으면 업그레이드 후 이 구현에 의존하는 기능을 테스트해야 합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다. 그렇지 않으면 업그레이드 후 이 구현에 의존하는 기능을 테스트해야 합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다. 그렇지 않으면 업그레이드 후 이 구현에 의존하는 기능을 테스트해야 합니다.@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다. 그렇지 않으면 업그레이드 후 이 구현에 의존하는 기능을 테스트해야 합니다.@api
(으)로 표시되지 않은 상수는 변경될 수 있습니다. 대신 사용자 지정 코드 내에 필요한 값의 개인 상수를 도입하고 사용하는 것이 좋습니다.@api
(으)로 표시되지 않은 상수는 변경될 수 있습니다. 대신 사용자 지정 코드 내에 필요한 값의 개인 상수를 도입하고 사용하는 것이 좋습니다.@api
(으)로 표시되지 않은 상수는 변경될 수 있습니다. 대신 사용자 지정 코드 내에 필요한 값의 개인 상수를 도입하고 사용하는 것이 좋습니다.@api
(으)로 표시되지 않은 인터페이스는 변경될 수 있습니다. @api
(으)로 표시된 Adobe Commerce 인터페이스 또는 사용자 지정 코드 범위에 도입된 인터페이스에서 이 상속을 제거하거나 상속으로 바꾸는 것이 좋습니다.@api
(으)로 표시되지 않은 인터페이스는 변경될 수 있습니다. @api
(으)로 표시된 Adobe Commerce 인터페이스 또는 사용자 지정 코드 범위에 도입된 인터페이스에서 이 상속을 제거하거나 상속으로 바꾸는 것이 좋습니다.@api
(으)로 표시되지 않은 상수는 변경될 수 있습니다. 대신 사용자 지정 코드 내에 필요한 값의 개인 상수를 도입하고 사용하는 것이 좋습니다.@api
(으)로 표시되지 않은 인터페이스는 변경될 수 있습니다. @api
(으)로 표시된 Adobe Commerce 인터페이스 또는 사용자 지정 코드 범위에 도입된 인터페이스에서 이 상속을 제거하거나 상속으로 바꾸는 것이 좋습니다.@api
(으)로 표시되지 않은 클래스는 변경될 수 있습니다. 대신 @api
(으)로 표시된 인터페이스를 사용하도록 코드를 업데이트하는 것이 좋습니다. 그렇지 않으면 업그레이드 후 이 구현에 의존하는 기능을 테스트해야 합니다. 또한 클래스의 인스턴스를 검색하는 권장 방법은 DI를 사용하는 것입니다. 클래스의 새 인스턴스가 필요한 경우 팩토리를 사용하는 것이 좋습니다.@api
(으)로 표시되지 않은 클래스는 변경될 수 있습니다. 대신 @api
(으)로 표시된 인터페이스를 사용하도록 코드를 업데이트하는 것이 좋습니다. 그렇지 않으면 업그레이드 후 이 구현에 의존하는 기능을 테스트해야 합니다.@api
(으)로 표시되지 않았거나 API 클래스/인터페이스 내에서 선언되지 않은 메서드는 변경될 수 있습니다. 메서드의 인터페이스가 새 버전에서 업데이트되지 않더라도 그 동작이나 출력이 다를 수 있습니다. 인터페이스 방법에 의존하는 것이 좋습니다. 그렇지 않으면 업그레이드 후 이 구현에 의존하는 기능을 테스트해야 합니다.@api
(으)로 표시되지 않은 속성의 값은 변경될 수 있습니다. 대신 API 인터페이스 메서드에 의존하는 것을 고려하십시오.@api
(으)로 표시되지 않은 속성의 값은 변경될 수 있습니다. 대신 API 인터페이스 메서드에 의존하는 것을 고려하십시오.@api
(으)로 표시되지 않은 속성의 값은 변경될 수 있습니다. 대신 API 인터페이스 메서드에 의존하는 것을 고려하십시오.@vars
주석 블록에 잘못된 JSON이 포함되어 있습니다.@vars
설명 블록에 잘못된 레이블이 있습니다.@vars
설명 블록에 템플릿에 사용된 변수가 없습니다."active"
특성은 사용되지 않습니다.<param>
노드는 사용되지 않습니다.<argument name="..." xsi:type="...">
을(를) 사용합니다.<instance>
노드는 사용되지 않습니다.<argument name="..." xsi:type="object">
을(를) 사용합니다.<array>
노드는 사용되지 않습니다.<argument name="..." xsi:type="array">
을(를) 사용합니다.<item key="...">
노드는 사용되지 않습니다.<item name="..." xsi:type="...">
을(를) 사용합니다.<value>
노드는 사용되지 않습니다.<supported_blocks>
<supported_containers>
(으)로 바꾸기<block_name>
<container_name>
(으)로 바꾸기"text/javascript"
형식 특성 사용 안 함Block
클래스의 보호된 멤버 및 전용 멤버에 대한 액세스는 phtml 템플릿에서 사용되지 않습니다.getConnection()
메서드를 사용하십시오.Zend_Db_Select
이(가) 제한되었습니다.\Magento\Framework\DB\Select
.Zend_Db_Adapter_Pdo_Mysql
이(가) 제한되었습니다.\Magento\Framework\DB\Adapter\Pdo\Mysql
.Magento\Framework\Serialize\Serializer\Serialize
이(가) 제한되었습니다.Magento\Framework\Serialize\SerializerInterface
.ArrayObject
이(가) 제한되었습니다.ArrayObject
에서 덮어쓴 serialize/unserialize 메서드로 확장되었습니다.Magento\Framework\View\Element\UiComponent\ArrayObjectFactory
이(가) 제한되었습니다.ArrayObject
에서 덮어쓴 serialize/unserialize 메서드로 확장되었습니다.output="toHtml"
은(는) 사용되지 않습니다.output="1"
사용.\Magento\Framework\View\Element\Text\ListText
클래스는 더 이상 레이아웃에서 사용할 수 없습니다.\Magento\Framework\View\Element\Text\ListText
클래스를 제거합니다.<action>
을(를) 통한 메서드 호출이 허용되지 않습니다.<action>
에서 잘못된 메서드를 사용하지 마십시오.helper
특성에 /
이(가) 포함되어 있음/
을(를) 제거합니다.helper
특성에 ::
이(가) 없습니다.::
을(를) 추가합니다.{{htmlescape}}
지시문은 사용되지 않습니다.{{var}}
을(를) 사용합니다.{{escapehtml}}
지시문은 사용되지 않습니다.{{var}}
을(를) 사용합니다.getChildHtml()
에 대해 세 번째 매개 변수가 더 이상 필요하지 않습니다.getChildHtml()
호출에서 세 번째 매개 변수를 제거합니다.getChildHtml()
에 더 이상 필요하지 않습니다.getChildHtml()
호출에서 네 번째 매개 변수를 제거합니다.final private
을(를) 찾을 수 있음final private
에서 private
(으)로만 변경합니다.__set_state
이(가) static
(으)로 정의되지 않았습니다.__set_state
은(는) static
(으)로 정의되어야 합니다.Stringable
인터페이스에서 __toString()
메서드가 상속되지 않은 클래스__toString()
메서드를 사용하여 클래스에 Stringable
인터페이스를 추가하십시오.is_resource()
메서드is_resource()
을(를) instanceof
개체로 변경합니다.jQuery.andSelf()
제거됨jQuery.addBack()
사용.$.bind
및 $.unbind
은(는) 더 이상 사용되지 않습니다.$.on
및 $.off
을(를) 사용합니다..on("event name", fn)
메서드를 사용하여 해당 이벤트에 가입하십시오..trigger("event name")
메서드를 사용하여 해당 이벤트를 트리거하십시오.$.delegate
및 $.undelegate
은(는) 더 이상 사용되지 않습니다.$.on
및 $.off
을(를) 사용합니다.jQuery.load()
/ jQuery.unload()
/ jQuery.error()
)이(가) 제거되었습니다..on("load", fn)
/ .on("unload", fn)
/ .on("error", fn)
)을(를) 사용합니다.jQuery.size()
제거됨jQuery.length
사용.jQuery.trim
은(는) 사용되지 않습니다.String.prototype.trim
사용.addButton
, addContextToolbar
, addMenuItem
, addSidebar
, file_browser_callback
, insert_button_items
, 'inlite' 테마, 'mobile' 테마, 'modern' 테마)가 제거되었습니다.jQuery.isFunction()
은(는) 사용되지 않습니다.jQuery.type()
은(는) 사용되지 않습니다.jQuery.isArray()
은(는) 사용되지 않습니다.jQuery.parseJSON()
은(는) 사용되지 않습니다.jQuery.expr[":"]
, jQuery.expr.filters
)은(는) 더 이상 사용되지 않습니다.DB 스키마
대상 Adobe Commerce 버전에서 추가 또는 제거된 데이터베이스 테이블, 열, 인덱스 또는 제약 조건이 사용자 지정 데이터베이스 스키마와 충돌할 수 있는 경우 DB 스키마 오류가 발생합니다.
경고
코어 코드
이러한 경고는 코어 코드 베이스에 사소한 불일치가 있는 경우 보고됩니다.
composer update <package_name>
을(를) 실행하여 종속성을 업데이트합니다.사용자 지정 코드
더 이상 사용되지 않는 코드에 대한 참조가 검색되면 사용자 지정 코드 경고가 발생합니다. 이러한 참조는 지원되는 확장 점으로 대체해야 합니다. 권장 사항에 더 이상 사용되지 않는 항목의 @see
주석을 주목하십시오. 이러한 오류는 작은 코딩 표준이 깨졌을 때도 보고된다.
@deprecated
클래스에서 확장@api
(으)로 표시된 클래스를 사용하도록 코드를 업데이트합니다.@deprecated
클래스를 가져오는 중@api
(으)로 표시된 Adobe Commerce 클래스를 사용하는 것이 좋습니다.@deprecated
클래스 로드 중@api
(으)로 표시된 Adobe Commerce 클래스를 사용하는 것이 좋습니다.@deprecated
클래스 사용 중@api
(으)로 표시된 Adobe Commerce 클래스를 사용하는 것이 좋습니다.@deprecated
상수 사용 중@api
또는 전용 상수로 표시된 상수를 대신 사용하는 것이 좋습니다.@deprecated
상수 재정의@api
또는 전용 상수로 표시된 상수를 대신 사용하는 것이 좋습니다.@deprecated
상수 할당@api
또는 전용 상수로 표시된 상수를 대신 사용하는 것이 좋습니다.@deprecated
인터페이스@api
(으)로 표시된 인터페이스 또는 클래스를 사용하는 것이 좋습니다.@deprecated
인터페이스@api
(으)로 표시된 인터페이스 또는 클래스를 사용하는 것이 좋습니다.@deprecated
인터페이스에서 상속됨@api
(으)로 표시된 인터페이스 또는 구현 내에 도입된 인터페이스를 사용하여 인터페이스 상속을 제거하는 것이 좋습니다.@deprecated
인터페이스 구현@api
(으)로 표시된 인터페이스 또는 구현 내에 도입된 인터페이스를 사용하여 인터페이스 상속을 제거하는 것이 좋습니다.@deprecated
메서드 호출@deprecated
속성 사용@deprecated
속성 재정의@deprecated
속성 할당getResource()
메서드가 사용됩니다.GraphQL 스키마
새 버전의 스키마에 추가 항목이 추가되면 GraphQL 스키마 경고가 발생합니다. 구현을 검토하여 요청에 사용해야 하는지 확인하는 것이 좋습니다.