構成と環境

WP STAGING CLI は、サイトを作成すると自動的に Docker 構成ファイルを生成します。本ガイドでは、高度な構成オプションと手動でのファイル生成について説明します。

構成ファイル

サイトを作成すると、WP STAGING CLI は次のファイルを ~/wpstaging/sites/<hostname>/ に生成します:

• docker-compose.yml – メインの Docker Compose 構成
• .env – 環境変数
• nginx/ – Nginx 構成と SSL 証明書
• php/ – PHP-FPM 構成
• mariadb/ – MariaDB 構成とデータ

hosts ファイルを更新する

ローカルドメインの解決のために、システムの hosts ファイルにエントリを追加または更新します:

wpstaging update-hosts-file

または、短いエイリアスを使用します:

wpstaging uhf

このコマンドは次のことを行います:

• 構成済みのすべてのサイトを読み取ります
• /etc/hosts (Linux/macOS) または C:\Windows\System32\drivers\etc\hosts (Windows) にエントリを追加します
• 各ホスト名を構成済みの IP アドレスにマッピングします

Compose ファイルを生成する

特定のサイトの docker-compose.yml ファイルを再生成します:

wpstaging generate-compose-file mysite.local

または、短いエイリアスを使用します:

wpstaging gcf mysite.local

次の場合に使用してください:

• Compose ファイルをデフォルトにリセットする
• 手動の構成変更後に更新する
• Docker の問題をトラブルシュートする

Docker ファイルを生成する

サイトのすべての Docker 構成ファイルを再生成します:

wpstaging generate-docker-file mysite.local

または、短いエイリアスを使用します:

wpstaging gdf mysite.local

これは次を再生成します:

• docker-compose.yml
• Nginx 構成
• PHP-FPM 構成
• 環境ファイル

SSL 証明書管理

WP STAGING CLI は mkcert を使用してローカルで信頼される SSL 証明書を生成します。

証明書を再インストールする

証明書の問題がある場合、サイトの SSL 証明書を再生成します:

wpstaging reinstall-cert mysite.local

認証局を再インストールする

証明書がブラウザで信頼されない場合、mkcert CA をシステム信頼ストアに再インストールします:

wpstaging reinstall-cert mysite.local --reinstall-ca

サイト構成を表示する

サイトの環境変数と構成を表示します:

wpstaging compose-info mysite.local

これにより、次を含む解析された docker-compose.yml の設定が表示されます:

• コンテナ名とイメージ
• ポートマッピング
• ボリュームマウント
• 環境変数

カスタム環境パス

デフォルトでは、すべての Docker 環境は ~/wpstaging に保存されます。カスタムパスを指定できます:

wpstaging add mysite.local --env-path=/custom/docker/path

次に、後続のすべてのコマンドで同じパスを使用してください:

wpstaging start --env-path=/custom/docker/path
wpstaging list --env-path=/custom/docker/path

カスタム Compose ファイルパス

docker-compose.yml ファイルのカスタム場所を指定します:

wpstaging add mysite.local --compose-file=/custom/path/docker-compose.yml

ポート構成

デフォルトポートが他のサービスと競合する場合、サイト作成時にカスタマイズしてください:

wpstaging add mysite.local \
  --http-port=8080 \
  --https-port=8443 \
  --db-port=3307 \
  --mailpit-http-port=8026

IP アドレス構成

デフォルトでは、サイトは 127.3.2.x 範囲の IP アドレス (ループバックアドレス) を使用します。これにより、複数のサイトが同じポート (80/443) で同時に実行できます。

wpstaging add mysite.local --container-ip=127.3.2.5

macOS IP エイリアス

macOS では、CLI は 127.3.2.x 範囲のアドレスに対して自動的に IP エイリアスを作成します。これには sudo アクセスが必要です。

構成コマンドのまとめ

ディレクトリ構造

デフォルトの環境ディレクトリ構造:

~/wpstaging/
├── sites/
│   └── mysite.local/
│       ├── docker-compose.yml
│       ├── .env
│       ├── www/                    # WordPress files
│       ├── nginx/
│       │   ├── nginx.conf
│       │   └── ssl/
│       │       ├── mysite.local.crt
│       │       └── mysite.local.key
│       ├── php/
│       │   └── php.ini
│       └── mariadb/
│           └── data/               # Database files
└── shared/
    └── mkcert/                     # CA certificates

次のステップ

• Docker WordPress サイトを管理する – サイトの作成と管理
• Docker コンテナを制御する – コンテナの起動、停止、アクセス