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コンテンツのあるページは以前どおりに見えます。編集者としてカーソルを合わせるとコントロールバーが出ます。小さな変更をしてSaveをクリックし、保存が効くか確認します。General SettingsにはLicense下のプロダクトキーが残っています。

DXPR Builder一般設定ページ

次にReports > Status report(/admin/reports/status)を開きます。DXPR Builder content migrationsの横にAll migrations completedと出ます。

新しい版が表示されない場合

  • エディターが古い版のまま振る舞う。 ブラウザーが古いエディターファイルを保持しています。Ctrl+Shift+Rキー(MacではCmd+Shift+Rキー)で再読み込みします。
  • 状態レポートに「Some DXPR Builder content migrations have not been completed」と出る。 コンテンツが変換待ちです。そのメッセージのView migration statusを開くか、/admin/dxpr_studio/dxpr_builder/migration-statusでRun all pending migrationsをクリックします。
  • ページが崩れているかエレメントがない。 更新後の問題で原因と対処法を確認できます。

更新でサイトが壊れ、上記で解決しない場合はロールバックします。

  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
    

次のステップ

  • バックアップと復元:大きな更新前のビルダーコンテンツ向けバックアップ手順を確認できます。
  • 変更履歴:各リリースの変更内容を確認できます。
  • 更新後の問題:よくある更新問題の対処法を確認できます。