2026年7月9日
2026年7月9日
WordPressのチェックサム(整合性チェック)エラー修復
はじめに
この記事では、WordPressサイトで発生したチェックサム(整合性チェック)エラーを修復するための手順について詳しく説明します。これらのエラーは通常、ファイルシステム内のデータの一貫性が失われた場合や、アップデート時に問題が発生した際に表示されます。適切な対処を行わないと、サイト全体が機能しなくなる可能性があります。
症状・背景
このテーマが必要になる主な場面:
- WordPressのアップデート後にエラー画面が出る
- ファイルシステム上のファイルが削除または改変された場合
- PHPエラーログで「WordPress checksum mismatch」などのメッセージが表示される
- サイト全体や特定ページが正しく機能しない
手順・設定方法
ステップ1: WordPressデータベースのバックアップを作成する
# データベース名、ユーザー名、パスワードを適切に変更してください。
mysqldump -u [database_username] -p[database_password] [database_name] > wp_database_backup.sql
ステップ2: WordPressのアップデートを実行する
# WP-CLIがインストールされている場合、以下のコマンドでWordPressを最新版に更新します。
wp core update --force
# アクティブテーマも更新しましょう。必要であればプラグインも同様に更新してください。
wp theme update all
ステップ3: ファイルの整合性チェックと修復を行う
# WP-CLIを使用して、ファイルの整合性を確認します。
wp core verify-checksums --path=/var/www/html/wordpress
# 整合性が合わない場合、以下のように正しいファイルに置き換えることができます。
wp core verify-checksums --force --path=/var/www/html/wordpress
ステップ4: キャッシュのクリアとサーバーの再起動
# サイト全体のキャッシュをクリアします(必要に応じて)
wp cache flush
# PHPのオペレーティングシステム上のキャッシュやtmpディレクトリもクリアする。
rm -rf /var/tmp/*
注意事項
- ファイルのバックアップは必ず取ってから修正作業を行います。万が一、修正が失敗した場合に備えます。
- WP-CLIを使用する前に、最新バージョンであることを確認してください。
- サーバー上でのファイル操作には十分な注意が必要です。間違って重要なファイルを削除しないようにしましょう。
まとめ
1. バックアップ: 操作前のデータベースとファイルのバックアップは必ず取得します。
2. 更新: WordPressおよび関連テーマやプラグインの最新版に更新してください。
3. チェックサム: ファイルの整合性を確認し、必要であれば修正を行います。
4. キャッシュクリア: キャッシュをクリアすることで問題が解決することがあります。
5. 再起動: 必要な場合にはサーバーを再起動して、変更が適切に反映されるようにします。
関連記事: