Web制作実務に特化したミニマルWordPressローカル環境構築ツール（WSL2 × Docker CLI）

概要

Web制作の現場でWordPress案件を開発する際、既存のローカル環境構築ツールでは対応しづらかった「実案件特有のディレクトリ構成」や「Windows環境での表示遅延」「ライセンス制限」を解決するために独自開発した、Docker CLIベースのWordPressローカル開発環境です。 MITライセンスのオープンソースとしてGitHubで公開しています。

開発の背景・解決したかった課題

Web制作の現場では以下のような課題がありました。

1. サブディレクトリ構成（/wp）の再現の手間 実案件では「トップページや静的ファイルはルート（/）に配置し、WordPress本体はサブディレクトリ（/wp）にインストールしてルートURLで公開する」構成が多くあります。しかし既存のGUIツール等ではルート直下へのインストールが前提となっていることが多く、実案件と同じディレクトリ階層を再現するのに手間がかかっていました。
2. Windows環境特有のページ遷移の遅さ Windows環境でWordPressをそのまま動かすと、ファイルI/Oのボトルネックによりページ遷移がワンテンポ遅れてしまい、開発体験や作業効率が低下する課題がありました。
3. Docker Desktop の商用ライセンス問題 Docker Desktop は一定規模以上の企業案件で有料サブスクリプションが必要となるため、環境に依存せず完全無料で使えるCLI完結の構成が求められていました。
4. 既存ツールの肥大化・ブラックボックス化 多機能すぎるツールは設定ファイルや独自コマンドが多く、トラブル時の原因切り分けに時間がかかるため、極限までファイル数・コード数を絞ったシンプルな構成を目指しました。

こだわり・技術的ポイント

• わずか2ファイル（compose.yml + .env）のミニマル設計 余計なラッパースクリプトを一切排除し、compose.yml（約65行）と .env（3行）のみで環境定義を完結させています。
• WP-CLI（wordpress-init）による初期セットアップの完全自動化 コンテナ起動時に wordpress:cli コンテナが自動で立ち上がり、DB接続待機・WordPressコアのインストール・日本語言語パックの導入と有効化・タイムゾーン（Asia/Tokyo）の設定までを自動実行します。コマンド1つですぐに日本語のWordPress管理画面へログイン可能です。
• WSL2 + Docker CLI による高速動作＆パーミッション問題の解消 WSL2のLinuxファイルシステム上で動作させることでWindows特有の遅延を解消。さらにコンテナの実行ユーザー（UID/GID）をローカルユーザーと揃える設計にし、WSL側からのファイル編集・移動時に発生しがちなパーミッションエラーを防いでいます。
• 環境変数（.env）による柔軟な構成切り替え .env の書き換えだけで、「サブディレクトリ（/wp）インストール」「サブディレクトリに置きつつルートURL（/）で公開」「ルート直下へのインストール」を柔軟に切り替えられるように設計しました。

使用技術

Docker / Docker Compose (CLI) / WSL2 (Linux) / WordPress / WP-CLI / MariaDB