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への移行)。
-
サイトのステージングコピーで更新を試します。
モジュールの更新
-
コードを更新します。
composer update drupal/dxpr_builder --with-dependencies -
データベース更新を実行します。代わりに
/update.phpを開くこともできます。drush updatedb一部の更新はすべてのDXPR Builderフィールド値をバッチで変換します。大規模サイトでは数秒ではなく数分掛かります。
-
キャッシュを再構築し、ブラウザーに新しいスタイルシートとスクリプトを届けます。
drush cache:rebuild
表示内容
DXPR Builderコンテンツのあるページは以前どおりに見えます。編集者としてカーソルを合わせるとコントロールバーが出ます。小さな変更をしてSaveをクリックし、保存が効くか確認します。General SettingsにはLicense下のプロダクトキーが残っています。

次に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をクリックします。 - ページが崩れているかエレメントがない。 更新後の問題で原因と対処法を確認できます。
更新でサイトが壊れ、上記で解決しない場合はロールバックします。
-
データベースバックアップを復元します。
drush sql:cli < backup-20260901.sql -
元の版に戻します(例:3.0.0-beta19)。
composer require 'drupal/dxpr_builder:3.0.0-beta19' -
キャッシュを再構築します。
drush cache:rebuild