WP STAGING CLI を使うと、ローカル開発・テスト用に Docker ベースの WordPress 環境を作成・管理できます。本ガイドでは、WordPress サイトの追加、リスト表示、削除、管理の方法について説明します。
取得できる内容
各 Docker サイトには以下が含まれます:
- 選択した PHP バージョンの PHP-FPM
- HTTPS 付きの Nginx Web サーバー
- MariaDB データベース
- メールテスト用の Mailpit
- mkcert による自動 SSL 証明書
- ローカルドメイン用の hosts ファイル構成
前提条件
- Docker 20.10.0 以降
- Docker Compose 2.19.0 以降
- 最低 2 CPU コアと 4 GB RAM
新しいサイトを追加する
カスタムのローカルドメインで新しい WordPress サイトを作成します:
wpstaging add https://mysite.localまたはプロトコルなしで:
wpstaging add mysite.localWordPress マルチサイトが必要ですか?
wpstaging add mysite.local --multisiteサイトが作成されたら、https://mysite.local でアクセスできます。
既存の Backup ファイルからサイトを追加する
新しいサイトを作成し、WP STAGING の Backup ファイルから 1 つの手順で復元します:
wpstaging add mysite.local --from=backup.wpstgまたはリモート URL から:
wpstaging add mysite.local --from=https://example.com/backup.wpstgWordPress マルチサイト:
wpstaging add mysite.local --multisite --from=BACKUP_URLこれは推奨される方法で、本番サイトのローカルコピーを作成します。Docker のセットアップ、Backup の展開、データベースのインポート、URL の置き換えなどすべてを処理します。
サイト構成をカスタマイズする
PHP バージョン
PHP バージョンを指定します (デフォルトは 8.1):
wpstaging add mysite.local --php=8.2利用可能な PHP バージョンはサポートされる Docker イメージによって異なります。
WordPress バージョン
特定の WordPress バージョンをインストールします (デフォルトは最新):
wpstaging add mysite.local --wp=6.4.2カスタムポート
他のサービスと競合する場合、デフォルトポートを変更します:
wpstaging add mysite.local \
--http-port=8080 \
--https-port=8443 \
--db-port=3307コンテナ IP アドレス
デフォルトでは、サイトは 127.3.2.x 範囲の IP アドレスを使用します。カスタム IP を指定できます:
wpstaging add mysite.local --container-ip=127.0.0.1環境パス
Docker 環境の保存場所を変更します (デフォルト: ~/wpstaging):
wpstaging add mysite.local --env-path=/custom/pathすべての add コマンドフラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
--php | 8.1 | PHP バージョン |
--wp | latest | WordPress バージョン |
--from | – | 復元する Backup ファイルパスまたは URL |
--env-path | ~/wpstaging | Docker 環境を保存するパス |
--container-ip | 127.3.2.1 | コンテナ IP アドレス |
--http-port | 80 | Nginx HTTP ポート |
--https-port | 443 | Nginx HTTPS ポート |
--db-port | 3306 | MariaDB ポート |
--db-root | 123456 | MariaDB root パスワード |
--mailpit-http-port | 8025 | Mailpit Web インターフェイスポート |
--disable-mailpit | false | Mailpit コンテナを無効化 |
WordPress 構成フラグ
| フラグ | デフォルト | 説明 |
|---|---|---|
--db-name | auto | WordPress データベース名 |
--db-user | auto | WordPress データベースユーザー |
--db-pass | auto | WordPress データベースパスワード |
--db-prefix | wp_ | WordPress テーブル接頭辞 |
--db-host | localhost | WordPress データベースホスト名 |
--db-ssl | false | WordPress データベース接続で SSL を有効化 |
--admin-user | admin | WordPress 管理者ユーザー名 |
--admin-pass | admin | WordPress 管理者パスワード |
--admin-email | admin@dev.null | WordPress 管理者メール |
--secure-credentials | false | ランダムなセキュアな認証情報を生成 |
--multisite | false | WordPress マルチサイトを有効化 |
サイトをリスト表示する
Docker 環境内のすべての WordPress サイトを表示します:
wpstaging list出力例:
HOSTNAME STATUS PHP IP
mysite.local running 8.1 127.3.2.1
dev.local stopped 8.2 127.3.2.2
test.local running 8.0 127.3.2.3特定のサイトの詳細を表示する
1 つ以上のサイトについて詳細情報を取得します:
wpstaging list mysite.localまたは複数のサイト:
wpstaging list site1.local site2.localサイトを削除する
特定のサイトを削除します:
wpstaging del mysite.local複数のサイトを削除します:
wpstaging del site1.local site2.localすべてのサイトを削除します (確認付き):
wpstaging del警告: サイトを削除すると、すべてのファイル、データベース、構成が削除されます。これは取り消せません。
サイトを有効化/無効化する
削除せずにサイトを無効化します:
wpstaging disable mysite.local無効化されたサイトを再度有効化します:
wpstaging enable mysite.local無効化されたサイトはデータを保持しますが、コンテナは起動されません。
サイトをリセットする
サイトを新規 WordPress インストールにリセットします:
wpstaging reset mysite.localこれにより、すべての WordPress コンテンツが削除され、Docker 構成は保持されたまま WordPress が再インストールされます。
異なる WordPress バージョンでリセットする
リセット中に異なる WordPress バージョンを指定します:
wpstaging reset mysite.local --wp=6.5リセットして Backup から復元する
サイトをリセットして、WP STAGING の Backup から 1 つの手順で復元します:
wpstaging reset mysite.local --from=backup.wpstg
wpstaging reset mysite.local --from=https://example.com/backup.wpstgセキュアな認証情報
セキュリティを向上させるため、特に共有環境では、ランダムな認証情報を使用してください:
wpstaging add mysite.local --secure-credentialsこれにより、以下のランダムなパスワードが生成されます:
- MariaDB root ユーザー
- WordPress データベースユーザー
- WordPress 管理者ユーザー
生成された認証情報はサイト作成後に表示されます。
WordPress マルチサイト
WordPress マルチサイトインストールを作成します:
wpstaging add mynetwork.local --multisitemacOS に関する注意
macOS ユーザーへ: ループバック IP 範囲 127.3.2.1 – 127.3.2.254 を使ったシームレスなマルチサイトセットアップのため、自動 IP エイリアスバインディングがデフォルトで有効になっています。これには sudo が必要で、パスワードの入力を求められます。
ヒント: パスワードの繰り返し入力を避けるには、wpstaging 用のパスワードレス sudo を設定してください。手順は FAQ をご覧ください。
次のステップ
- Docker コンテナを制御する – コンテナの起動、停止、管理
- Docker 構成 – 高度な構成オプション
- WordPress サイトのローカルコピーを作成する – 完全なチュートリアル