WP STAGING CLI には、Backup ファイルを展開せずに検査するコマンドが用意されています。Backup の内容を検証する、Backup メタデータを確認する、展開前に Backup の中身を理解する、といった用途に便利です。
利用可能な検査コマンド
| コマンド | エイリアス | 説明 |
|---|---|---|
dump-header | dh | Backup の形式とバージョン情報を表示 |
dump-metadata | dm | Backup の作成詳細とサイト情報を表示 |
dump-index | di | Backup 内のファイルリストを表示 |
Backup ヘッダーを表示する
ヘッダーには Backup 形式に関する基本情報が含まれます:
wpstaging dump-header backup.wpstgまたは、短いエイリアスを使用します:
wpstaging dh backup.wpstg出力例:
Backup Header Information
-------------------------
Format Version: v2
Compression: gzip
Created By: WP STAGING Pro 5.xこれにより以下を検証できます:
- Backup ファイルが有効である
- 形式のバージョン (v1 または v2)
- Backup を作成したツール
Backup メタデータを表示する
メタデータには Backup とソースサイトに関する詳細情報が含まれます:
wpstaging dump-metadata backup.wpstgまたは、短いエイリアスを使用します:
wpstaging dm backup.wpstg出力例:
Backup Metadata
---------------
Site URL: https://example.com
Site Name: My WordPress Site
WordPress Version: 6.4.2
PHP Version: 8.1.27
Database Prefix: wp_
Backup Date: 2024-01-15 14:30:00 UTC
Backup Size: 1.2 GB
Files Count: 15,432
Is Multisite: Noこの情報は以下に役立ちます:
- 正しい Backup を持っているか確認
- 復元前に元のサイト URL を確認
- 使用された WordPress と PHP のバージョンを理解
- 構成のためにデータベース接頭辞を知る
ファイルインデックスを表示する
ファイルインデックスには Backup に含まれるすべてのファイルが表示されます:
wpstaging dump-index backup.wpstgまたは、短いエイリアスを使用します:
wpstaging di backup.wpstg出力例:
File Index
----------
wp-config.php
wp-content/themes/twentytwentyfour/style.css
wp-content/themes/twentytwentyfour/functions.php
wp-content/plugins/wp-staging-pro/wp-staging-pro.php
wp-content/uploads/2024/01/image.jpg
...
Total: 15,432 files詳細なインデックスデータを表示する
ファイルサイズやオフセットを含む詳細情報を表示するには、--data フラグを使用します:
wpstaging dump-index --data backup.wpstg出力例:
File Index (Detailed)
---------------------
Path Size Offset Chunks
wp-config.php 3,245 1024 1
wp-content/themes/twentytwentyfour/style.css 45,678 4,269 1
wp-content/uploads/2024/01/large-image.jpg 5,234,567 50,000 3
...詳細ビューには以下が表示されます:
- Path: WordPress ルートからの相対ファイルパス
- Size: 元のファイルサイズ (バイト)
- Offset: Backup ファイル内の位置
- Chunks: データチャンクの数 (大きなファイルは分割されます)
ユースケース
復元前に Backup を検証する
Backup を復元する前に、その内容を確認します:
# Check it's the right site
wpstaging dm backup.wpstg
# Verify specific files are included
wpstaging di backup.wpstg | grep wp-config.php
wpstaging di backup.wpstg | grep "my-custom-plugin"Backup の日付とソースを特定する
複数の Backup ファイルがあり、それらを特定する必要がある場合:
# Check each backup's metadata
wpstaging dm backup-2024-01-15.wpstg
wpstaging dm backup-2024-01-20.wpstg特定のファイルを確認する
展開前に特定のファイルが含まれているか確認します:
# Check if database file is included
wpstaging di backup.wpstg | grep "\.sql"
# Check for specific plugin
wpstaging di backup.wpstg | grep "woocommerce"
# Check for uploads
wpstaging di backup.wpstg | grep "wp-content/uploads" | head -20Backup の問題をトラブルシュートする
展開に失敗した場合、これらのコマンドを使って診断してください:
# Verify backup is valid
wpstaging dh backup.wpstg
# Check if metadata is readable
wpstaging dm backup.wpstg
# Verify file index is intact
wpstaging di backup.wpstg出力ディレクトリオプション
すべての検査コマンドは、一時ファイル用に --outputdir フラグをサポートしています:
wpstaging dump-metadata --outputdir=/tmp/wpstaging backup.wpstgBackup 構造を理解する
WP STAGING の Backup は、以下のコンポーネントを持つ独自形式を使用します:
- ヘッダー: バージョン識別子と形式情報
- メタデータ: PHP シリアライズされた Backup 情報 (作成日、サイト情報など)
- ファイルインデックス: パス、サイズ、チャンクオフセット付きのファイルの圧縮リスト
- ファイルデータ: チャンク化され圧縮されたファイル内容
検査コマンドは完全な Backup を展開せずにこれらのセクションを解析するため、大きな Backup でも高速です。
次のステップ
- Backup ファイルを展開する – Backup の内容を展開
- Backup から WordPress を復元する – サイト全体の復元
- WordPress サイトのローカルコピーを作成する – Docker ベースのローカル環境
