データベース更新のトラブルシューティング

データベース更新の問題をトラブルシューティングする前に、必ずデータベースとコードベースをバックアップしてください。

データベース更新の安全な実行を妨げる問題がある場合、update.php はエラーを表示します。

問題を特定するために、エラーメッセージを注意深く読んでください。

無効なモジュールまたはテーマ

ときには、update.php が無効なモジュールやテーマを報告することがあります。これは、モジュールやテーマが core.extension.yml に記載されているのに、存在しないか、サイトと互換性がない場合に起こります。

これを解決するには:

1. 誤ったバージョンの core.extension.yml をインポートしていないことを確認します。
2. 表示された具体的なエラーメッセージに基づいて、さらに原因を診断します。
3. 問題を解決した後、update.php を再実行します。

モジュールまたはテーマの欠落

1. モジュールやテーマのフォルダーがコードベースに存在するか確認します――[site-root]/modules と [site-root]/sites/all/modules を見てください。
2. 欠落している場合は、Drupal.org からモジュールをダウンロード し、あなたの Drupal バージョンと互換性があることを確認します。
3. フォルダーは存在するが不完全または破損している場合は、再度ダウンロードして、正常なコピーと置き換えます。
4. カスタムモジュールやサードパーティのモジュール(たとえば GitHub からのもの)の場合は、元のバージョンを取得してみてください。
5. 最後の手段として、core.extension.yml を編集してそのエントリを削除することもできますが、これは他の致命的なエラーを引き起こす可能性があります。
6. 問題を修正した後、update.php を再実行します。

Drupal コアバージョンとの非互換

1. update.php がモジュールやテーマの非互換を報告した場合、Reports(レポート) > Status report(ステータスレポート) から現在の Drupal コアバージョンを確認します。
2. モジュールの .info.yml ファイルで互換性キーを確認します:

core: 8.x
core_version_requirement: ^8.8 || ^9

これは、Drupal 8.8 以降と 9 の両方に互換性があることを意味します。

core_version_requirement: ^9

これは、Drupal 9 のみに互換性があることを意味します。

core: 8.x

Drupal 8 のみに互換性があります。

core: 7.x

Drupal 7 のみに互換性があります。

3. Drupal コア、またはモジュール/テーマを互換性のあるバージョンに更新します。
4. 互換性のあるバージョンが存在しない場合は、バックアップから復元します。
5. その後、update.php を再実行します。

インストール済みの PHP バージョンとの非互換

1. .info.yml で次のような行を確認します:

php: 7.3

2. オプション 1:あなたの PHP バージョンをサポートするバージョンのモジュールやテーマをインストールします。
3. オプション 2:PHP バージョンを、モジュールと互換性のあるものに変更します。
4. PHP とモジュールが互換になったら、update.php を再実行します。