DXPR Builder 업데이트.

DXPR Builder 배우기여기서 시작설치 및 업데이트

버그 수정, 새 기능, 보안 수정을 받으려면 DXPR Builder를 업데이트합니다. Composer로 코드를 업데이트한 뒤 drush updatedb로 Drupal이 설정과 콘텐츠를 변환하도록 합니다. 3.x 시리즈 내의 업데이트에는 이 페이지를 사용합니다. 1.x나 2.x에서 가져오나요? 대신 DXPR Builder 1.x 또는 2.x에서 마이그레이션을 따릅니다.

시작하기 전에

  • 데이터베이스를 백업합니다.

    drush sql:dump > backup-$(date +%Y%m%d).sql

  • 먼저 변경 로그와 GitHub 릴리스 페이지에서 조치 필요한 변경 사항(예: Font Awesome 7로의 이동)을 읽습니다.

  • 먼저 스테이징 복사본에서 업데이트를 시험합니다.

모듈 업데이트

  1. 코드를 업데이트합니다.

    composer update drupal/dxpr_builder --with-dependencies

  2. 데이터베이스 업데이트를 실행합니다. 대신 /update.php를 방문해도 됩니다.

    drush updatedb

    일부 업데이트는 모든 DXPR Builder 필드 값을 일괄 방식으로 변환합니다. 대규모 사이트에서는 수초가 아니라 수분이 걸립니다.

  3. 캐시를 다시 빌드하여 브라우저가 새 스타일시트와 스크립트를 받도록 합니다.

    drush cache:rebuild

표시 내용

DXPR Builder 콘텐츠가 있는 페이지는 이전과 같은 모습입니다. 에디터로 마우스를 올리면 컨트롤 바가 표시됩니다. 작은 변경을 하고 저장을 클릭하여 저장이 작동하는지 확인합니다. 일반 설정의 라이선스에 여전히 제품 키가 표시됩니다.

DXPR Builder 일반 설정 페이지

그런 다음 보고서 > 상태 보고서(/admin/reports/status)를 엽니다. DXPR Builder 콘텐츠 마이그레이션 옆에 모든 마이그레이션 완료라고 표시됩니다.

새 버전이 표시되지 않는 경우

  • 에디터가 여전히 이전 버전처럼 작동합니다. 브라우저가 이전 에디터 파일을 유지하고 있습니다. Ctrl+Shift+R(Mac에서는 Cmd+Shift+R)로 다시 로드합니다.
  • 상태 보고서에 “일부 DXPR Builder 콘텐츠 마이그레이션이 완료되지 않았습니다(Some DXPR Builder content migrations have not been completed)”라고 표시됩니다. 콘텐츠가 아직 변환 대기 중입니다. 해당 메시지의 마이그레이션 상태 보기를 열거나 /admin/dxpr_studio/dxpr_builder/migration-status로 이동하여 모든 대기 마이그레이션 실행을 클릭합니다.
  • 페이지가 잘못 표시되거나 요소가 없습니다. 원인과 해결 방법은 업데이트 후 문제를 참조하세요.

업데이트로 사이트가 깨지고 위의 방법으로도 해결되지 않으면 롤백합니다.

  1. 데이터베이스 백업을 복원합니다.

    drush sql:cli < backup-20260901.sql

  2. 사용하던 버전(예: 3.0.0-beta19)을 복원합니다.

    composer require 'drupal/dxpr_builder:3.0.0-beta19'

  3. 캐시를 다시 빌드합니다.

    drush cache:rebuild

다음 단계