Backup を展開する

extract コマンドは、WordPress インストールが実行中でなくても WP STAGING の Backup (.wpstg) からファイルとデータベースを取り出します。災害復旧、サイトの検査、手動インポート用のファイル準備に有用です。

取得できる内容

展開後、次が得られます:

すべての WordPress ファイル (コア、Theme、Plugin、アップロード)
インポートできるデータベース SQL ファイル
元の設定が入った wp-config.php

基本的な展開

デフォルトの出力ディレクトリ (./wpstaging-output) にすべてのファイルとデータベースを展開します:

wpstaging extract backup.wpstg

または --from フラグを使用します:

wpstaging extract --from=backup.wpstg

リモート URL から展開する

リモートの Backup ファイルから、手動でダウンロードすることなく直接展開します:

wpstaging extract --from=https://example.com/backups/backup.wpstg

または URL を引数として直接渡します:

wpstaging extract https://example.com/backups/backup.wpstg

動作:

リモートファイル (サイズと形式) を検証します
Backup 情報を表示します
ダウンロード前に確認を求めます
進行インジケータ付きでダウンロードします (中断されたダウンロードのレジュームをサポート)

カスタムディレクトリに展開する

ファイルを展開する場所を指定します:

wpstaging extract --outputdir=/var/www/restored-site backup.wpstg

短い形式:

wpstaging extract -o /var/www/restored-site backup.wpstg

データベース正規化付きで展開する

WP STAGING の Backup にはデータベースファイル内にプレースホルダーが含まれています。--normalizedb を使用して実際の値に置き換え、SQL ファイルを標準のデータベースツールで使用できる状態にします:

wpstaging extract --normalizedb backup.wpstg

これにより、次のようなプレースホルダーが置き換えられます:

{WPSTG_TMP_PREFIX} → 一時テーブル接頭辞
{WPSTG_FINAL_PREFIX} → 最終テーブル接頭辞
{WPSTG_NULL} → SQL NULL
{WPSTG_BINARY} → BINARY データ型

サイト URL とデータベース接頭辞を置き換える

新しい環境用にサイト URL とデータベース接頭辞を変更しながら展開します:

wpstaging extract --normalizedb \
  --site-url=https://newdomain.com \
  --db-prefix=wp_new_ \
  backup.wpstg

注: --site-url または --db-prefix を使用する場合、--normalizedb フラグが必要です。

展開するものをフィルタリングする

Backup の特定部分を展開するには --only-* フラグを使用します:

フラグ	短形式	説明
`--only-wproot`	`-r`	WordPress ルートファイルのみ展開
`--only-wpcontent`	`-w`	wp-content ディレクトリのみ展開
`--only-plugins`	`-i`	Plugin のみ展開
`--only-themes`	`-t`	Theme のみ展開
`--only-muplugins`	`-m`	must-use Plugin のみ展開
`--only-uploads`	`-u`	アップロードのみ展開
`--only-languages`	`-g`	言語ファイルのみ展開
`--only-dbfile`	`-b`	データベースファイルのみ展開
`--only-dropins`	`-e`	drop-in ファイルのみ展開
`--only-file`	`-f`	この名前に一致するファイルのみ展開

例 – データベースファイルのみ展開:

wpstaging extract --only-dbfile backup.wpstg

例 – Plugin のみ展開:

wpstaging extract -i backup.wpstg

特定部分をスキップする

展開から部分を除外するには --skip-* フラグを使用します:

フラグ	短形式	説明
`--skip-wproot`	`-R`	WordPress ルートファイルをスキップ
`--skip-wpcontent`	`-W`	wp-content ディレクトリをスキップ
`--skip-plugins`	`-I`	Plugin をスキップ
`--skip-themes`	`-T`	Theme をスキップ
`--skip-muplugins`	`-M`	must-use Plugin をスキップ
`--skip-uploads`	`-U`	アップロードをスキップ
`--skip-languages`	`-G`	言語ファイルをスキップ
`--skip-dbfile`	`-B`	データベースファイルをスキップ
`--skip-dropins`	`-E`	drop-in ファイルをスキップ
`--skip-file`	`-F`	この名前に一致するファイルをスキップ

例 – アップロード以外すべてを展開:

wpstaging extract --skip-uploads backup.wpstg

例 – データベースとアップロードをスキップ:

wpstaging extract -B -U backup.wpstg

展開ファイルを検証する

Backup とチェックサムを比較して展開ファイルの整合性を検証します:

wpstaging extract --verify backup.wpstg

上書きの挙動

デフォルトでは、展開は既存ファイルを上書きします。これを制御するには:

# Skip overwriting (default is yes)
wpstaging extract --overwrite=no backup.wpstg

すべての extract フラグ

Flags:
  -o, --outputdir string   Directory for extracted files (default: ./wpstaging-output)
  -n, --normalizedb        Normalize database files during extraction
      --overwrite string   Overwrite existing extraction directory (yes/no) (default "yes")
      --site-url string    Specify a new WordPress site URL
      --verify             Verify integrity of extracted files
      --db-prefix string   Specify a new WordPress database table prefix
      --from string        Backup file path or remote URL (http/https)

よくあるユースケース

災害復旧

WordPress インストールが壊れた場合に、Backup からファイルを展開します:

wpstaging extract --normalizedb --outputdir=/var/www/recovery backup.wpstg

手動インポート用にデータベースのみを展開する

データベース SQL ファイルだけを取得します:

wpstaging extract --only-dbfile --normalizedb backup.wpstg

新しいドメインに移行する

移行用に新しいサイト URL で展開します:

wpstaging extract --normalizedb \
  --site-url=https://newsite.com \
  --outputdir=/var/www/newsite \
  backup.wpstg

次のステップ

Backup から WordPress を復元する – 完全な自動復元の場合
Backup ファイルを検査する – 展開前に Backup の内容を表示
WordPress サイトのローカルコピーを作成する – Docker ベースのローカルコピーを構築