업데이트 후 문제.

DXPR Builder 배우기사이트 관리문제 해결

잘못된 업데이트를 마무리합니다. 거의 모든 경우 코드는 업데이트되었지만 데이터베이스는 업데이트되지 않았거나, 남아 있는 모듈 사본이 방해하거나, 종속성이 누락된 것입니다.

올바른 순서로 업데이트 실행

  1. 데이터베이스를 백업합니다.
  2. composer require drupal/dxpr_builder를 실행합니다. 릴리스를 고정한다면 버전 제약을 지정합니다.
  3. drush updb -y를 실행합니다(/update.php 방문도 가능).
  4. drush cr을 실행합니다.
  5. 빌더 페이지 하나를 열고 다시 저장합니다.

Important: 업데이트를 위해 모듈을 절대 제거하지 않습니다. 제거하면 저장된 템플릿, 프로필, 설정이 삭제됩니다.

Composer에 오류가 표시됩니다

  • “Could not find a version of package drupal/dxpr_builder matching your minimum-stability”. 3.x는 베타 릴리스로 게시됩니다. 제약 조건에서 베타를 허용합니다: composer require 'drupal/dxpr_builder:^3.0@beta'.
  • “Could not find a matching version of package dxpr/dxpr_builder”. drupal.org의 패키지는 drupal/dxpr_builder입니다. dxpr/dxpr_builder → drupal/dxpr_builder (파일: composer.json). 변경한 뒤 composer update drupal/dxpr_builder를 실행합니다.
  • 폴더가 Composer로 관리되지 않아 Composer가 거부합니다. 사본이 수동으로 업로드되었습니다. modules/contrib/dxpr_builder를 삭제한 뒤 require 명령을 다시 실행합니다.
  • “Disk quota exceeded” 또는 “write failed”. 다시 시도하기 전에 서버의 디스크 공간을 확보합니다.

데이터베이스 업데이트가 실패합니다

  • “Unable to install modules key due to missing modules key”. 3.x에는 Key 모듈이 필요하며 업데이트 9020에서 이를 설치합니다. 모듈이 Composer로 설치되지 않아 코드가 없습니다. composer require drupal/key를 실행합니다. 다음으로 drush updb -y를 다시 실행합니다.
  • 지정된 업데이트 훅이 실패합니다. drush updb -vvv를 실행한 뒤 전체 오류를 티켓에 포함합니다.
  • “module 'dxpr_builder_page' is missing its dependency module field_group”. DXPR Builder Drag and Drop Page 서브모듈에는 Field Group이 필요합니다. composer require drupal/field_group을 실행합니다. 다음으로 drush en dxpr_builder_page -y를 실행합니다.

업데이트 후 페이지가 깨져 보입니다

일부 릴리스는 drush updb 실행 중에 배치 방식으로 이전 마크업을 새 형식으로 변환합니다(예: Owl 캐러셀, 원형 카운터). 실패한 항목은 대기 상태로 남습니다.

  1. 다음으로 이동합니다: DXPR Studio > DXPR Builder > Content items > Migrations(/admin/dxpr_studio/dxpr_builder/migration-status).
  2. 마이그레이션에 Pending이 표시되면 Run now 또는 Run all pending migrations을 클릭합니다.
  3. Reports > Recent log messages에서 배치가 건너뛴 항목을 확인합니다.

Composer가 Drupal 코어 메이저 업그레이드를 거부합니다

DXPR Builder 3.x는 Drupal 10.2 이상과 Drupal 11을 지원합니다.

  1. 새 메이저를 지원하는 버전을 DXPR Builder, DXPR Theme, DXPR Theme Helper의 릴리스 노트에서 확인합니다.
  2. Upgrade Status를 실행하여 준비되지 않은 패키지를 확인합니다.
  3. composer.json에서 코어 메이저를 고정합니다. 제약이 없으면 composer require drupal/core-recommended가 다음 메이저를 실수로 가져올 수 있습니다.

업데이트 직후 에디터가 고장났습니다

다음 문서를 따릅니다: The editor does not appear. 부분 업데이트 후에 나타나는 주요 원인이 그곳에 있습니다. 보류 중인 데이터베이스 업데이트, 오래된 파일, 이전 릴리스로 빌드된 집계 캐시입니다.

Glazed Builder에서 마이그레이션합니다

DXPR Builder 3.x는 저장된 콘텐츠의 Glazed 클래스 이름을 더 이상 변환하지 않습니다. 먼저 마지막 2.x 릴리스로 업데이트하고 데이터베이스 업데이트를 실행한 뒤 3.x로 업데이트합니다. Migrating from DXPR Builder 1.x or 2.x를 참조합니다.

수정 확인하기

drush updb에 보류 중인 업데이트가 없고, drush pm:list --filter=dxpr에 의도한 버전이 표시되며, 다시 저장한 빌더 페이지가 에디터와 방문자에게 동일하게 렌더링됩니다.

다음 단계

Updating DXPR Builder에서 정기 업데이트 절차를 확인합니다.