WordPress Migration とアップグレード レビュー スキル

概要

WordPress プラグインおよびテーマのアップグレード ルーチンの体系的なレビューを行います。**基本原則:**アップグレードは反復可能で、バージョン認識を持ち、段階的で、本番環境の実データに対して安全であるべきです。スキーマの変更、オプション マイグレーション、バージョン フラグ、アクティベーション時のアップグレード、バックグラウンド バックフィル、べき等性、ロールバック リスク、および後方互換性をカバーします。

使用するタイミング

使用する場合:

• スキーマまたはオプション マイグレーションのレビュー
• dbDelta() の使用方法を監査する
• バージョン管理されたアップグレード ルーチンを確認する
• バックグラウンド バックフィルまたはワンタイム修復ジョブのレビュー
• 既存インストール向けのリスキーなリリースを準備する

使用しない場合:

• マイグレーション ロジックなしのパフォーマンス レビュー
• アップグレード コンテキストなしの一般的なプラグイン アーキテクチャ レビュー
• 製品アップグレードに関連しないワンオフのコンテンツ インポート

コード レビュー ワークフロー

1. マイグレーション対象を特定する

   • アクティベーション フック セットアップ
   • バージョン比較アップグレード ルーチン
   • バックグラウンド バックフィル
   • 手動修復ツール

2. 安全性を最優先でチェックする

   • バージョン ガード が存在する
   • ルーチンがべき等である
   • 破壊的な操作が明示的で正当化されている
   • 大規模なデータ作業が分割されている

3. スキーマとデータ フローをレビューする

   • dbDelta() 対 生 SQL
   • オプションの名前変更/コピー/削除の順序
   • バックフィルの永続性と進捗トラッキング
   • アップグレード完了フラグ

4. 重大度を適用する

   • 重大: バージョン ガードなし、チェックなしの破壊的な書き込み、ページ読み込み時の長時間実行アップグレード
   • 警告: バッチ処理なし、ロールバック検討の不足、未追跡の部分的状態
   • 情報: マイグレーション レジストリまたはログをさらに明確にできる可能性

ファイルタイプ別チェック

バージョン管理されたアップグレード ルーチン

• 重大: バージョン比較なしにリクエストごとに実行されるアップグレード ロジック
• 警告: 複数のマイグレーション ステップがあるが順序付きアップグレード マップがない
• 情報: マイグレーション レジストリを集約化できる可能性

スキーマ変更

• 重大: 既存インストール を考慮せずに生の CREATE TABLE または ALTER TABLE を使用
• 警告: テーブル バージョン トラッキングなしで dbDelta() を使用
• 情報: スキーマとデータ マイグレーション フェーズを分離できる可能性

データ バックフィル

• 重大: 通常のページ読み込み時に全テーブル バックフィルを実行
• 警告: バッチ処理や進捗オプションがない
• 警告: リトライまたは再開可能な設計がない
• 情報: Action Scheduler または WP-CLI サポートを使用できる可能性

クイック検出用の検索パターン (MIG-21)

これらの rg コマンドを使用してマイグレーションを素早くスキャンします。

重大パターン

# Version comparisons and upgrade flags
rg -n "version_compare|get_option\s*\(.*version|update_option\s*\(.*version" . -g '*.php'

# Schema changes
rg -n "dbDelta|CREATE TABLE|ALTER TABLE|DROP TABLE" . -g '*.php'

# Activation and upgrade hooks
rg -n "register_activation_hook|upgrader_process_complete|admin_init|init" . -g '*.php'

警告パターン

# Batch candidates and large loops
rg -n "foreach|while" . -g '*.php'

# Background processing and schedulers
rg -n "wp_schedule_event|as_schedule_single_action|WP_CLI" . -g '*.php'

# Delete or rename operations
rg -n "delete_option|rename|migrate|backfill" . -g '*.php'

情報パターン

# Upgrade classes or managers
rg -n "Migration|Upgrade|Installer|Schema" . -g '*.php'

参考ファイル

• references/versioned-upgrades.md - バージョン フラグ、順序付きマイグレーション、およびべき等なアップグレード ルーチン
• references/schema-and-backfill-guide.md - dbDelta()、テーブル変更、バックフィル、バッチ処理、およびリリース安全性

出力形式 (MIG-23)

各検出結果について、重大度、ファイル参照、マイグレーション リスク、および安全な修復パスを含めます。本番環境のタイムアウト、部分的なデータ状態、または取り消せないデータ損失のリスクがある場合は明示的に記載してください。