WordPressのローカル環境の作り方｜4つの方式の違いと選び方

結論

ローカル環境は、自分のパソコンの中に作る、WordPress の練習場兼作業場です。テーマ作りや設定変更は、まずローカル環境で試してから本番サイトへ反映するのが基本です。

方式は大きく4つあります。初めてなら、画面の操作だけでサイトを作れるデスクトップアプリ型から始めるのが最も手軽です。ただし、チーム開発やブロック開発を本格的に行うなら、公式がブロック開発に推奨している wp-env（Docker 型）を選びます。

基本（なぜローカル環境が必要か）

本番サイトで直接コードを書くと、書き間違い1つで画面が真っ白になり、閲覧者に影響が出ます。公式のデバッグ解説も、WP_DEBUG などのデバッグ機能は本番サイトでは推奨せず、ローカルやステージング（本番前の確認用サイト）で使うものだとしています。ローカル環境なら、壊しても自分のパソコンの中だけで済みます。

公式の Block Editor Handbook の「開発環境」の章では、次のツールが紹介されています。

方式 主なツール やさしい言い換え 向いている人
デスクトップアプリ型 WordPress Studio、Local アプリを入れて、ボタンでサイトを作る 初めての人、テーマ制作の練習
Docker 型 wp-env 「コンテナ」という箱の中に環境を作る ブロック開発、チームで同じ環境をそろえたい人
パッケージ型 XAMPP、MAMP Webサーバー・PHP・DBを一式まとめて入れる PHP の仕組みも学びたい人
ブラウザ型 WordPress Playground ブラウザの中だけで WordPress を動かす まず触ってみたい人、短時間の検証

公式文書では、wp-env は WordPress プロジェクト自身が保守するオープンソースで、ブロック（Gutenberg）開発に推奨のツールと説明されています。XAMPP は、Apache・MariaDB・PHP・Perl を含む無料の配布物です。WordPress Playground は、ホスト（サーバー）なしでどの端末でもすぐ WordPress を動かせる仕組みとして紹介されています。

具体例（デスクトップアプリ型: Local の手順）

Local の公式ドキュメントに沿った最小の流れです（ほかのデスクトップアプリ型も流れは似ています）。

  1. 公式サイト（https://localwp.com/）のダウンロードページから、自分の OS 用のファイルを入れる。Windows はインストーラーの案内どおりに進め、途中の「アクセスを許可する」の確認は許可する。公式ドキュメントでは、メモリ 4GB 以上、空き容量 1.5GB 以上が必要とされている（2026年10月7日確認）。
  2. Local を開き、「＋」ボタンで新しいサイトを作る。サイト名を入れ、環境は「Preferred」を選び、WordPress のユーザー名・パスワード・メールアドレスを入れる。
  3. 「WP Admin」ボタンで管理画面を開く。
  4. サイトのファイルは、ホームフォルダ（Windows は C:Usersユーザー名、Mac は Finder の「ホーム」）の Local Sites/サイト名/app/public にある。テーマは wp-content/themes/、設定ファイル wp-config.php は app/public の直下。

具体例（wp-env の起動手順）

公式の「Get started with wp-env」に沿った最小の流れです。

  1. Docker Desktop と Node.js（npm を含む）を入れる。
  2. ターミナルで npm -g install @wordpress/env を実行する。
  3. テーマやプラグインのフォルダで wp-env start を実行する。
  4. ブラウザで http://localhost:8888/wp-admin を開き、公式文書に記載の初期ユーザー（admin / password）でログインする。
  5. 作業が終わったら wp-env stop で止める。

初期ユーザーとパスワードは公式文書に公開されている値なので、ローカルの練習専用です。外部から見える環境では使いません。Docker Desktop は、個人利用・教育などは無料で使える一方、商用利用では条件がある旨が公式文書で触れられています。

実践のステップ（選び方）

  1. 目的を決める: テーマ作りの練習か、ブロック開発か、ちょっとした動作確認か。
  2. パソコンの条件を確かめる: OS（Windows / macOS / Linux）と、管理者権限でソフトを入れられるか。
  3. 方式を選ぶ: 迷ったらデスクトップアプリ型、Docker を使えるならwp-env、インストールせず試すなら Playground。
  4. 本番に近づける: 本番サーバーと同じ PHP のバージョンに合わせる。本番がまだ無い人は、選べる中で推奨の PHP 8.3 以上にしておけば足りる。
  5. テーマのフォルダを決める: wp-content/themes/ の場所を確認し、メモ帳ではなくコードエディタで開く。例として Visual Studio Code は、公式の FAQ で個人・商用とも無料とされ、File → Open Folder でフォルダを開ける。ファイルは UTF-8 で保存し（画面右下の表示で確かめる）、拡張子（.php・.css）まで自分で付ける。
  6. デバッグを有効にする: wp-config.php にある define( 'WP_DEBUG', false ); の false を true に書き換え、エラーを見ながら作業する（行が無ければ、stop editing と書かれたコメント行より上に define( 'WP_DEBUG', true ); を足す。WordPress 画面が真っ白になる原因とWP_DEBUGでの調べ方）。

WordPressのローカル環境の作り方の注意点

  • ローカルのURLを本番に持ち込まない: ローカルで作った記事や設定を本番へ移すと、localhost の URL が残ることがあります。データベースの文字列を単純に置換すると、シリアライズされたデータを壊すおそれがあるため、専用の置換手段を使います。
  • 公開しない前提: XAMPP の公式FAQは、XAMPP は本番用ではなく開発環境専用で、開発者が何でもできるよう開放的に設定されていると説明しています。外部に公開する用途には使いません。
  • データの保存: Playground はブラウザ内で動くため、作業内容を残す方法を事前に確認します。

WordPressのローカル環境の作り方でよくあるミス

  • 本番サイトの管理画面のテーマエディタで直接コードを直し、画面が真っ白になる。
  • ローカルの PHP が本番より新しく、ローカルでは動いたのに本番でエラーになる。
  • テーマのフォルダを wp-content/themes/ の外に作り、テーマ一覧に出てこない。
  • 複数のツールを同時に起動し、ポート番号（8888 など）がぶつかって起動しない。

WordPressのローカル環境の作り方のチェックリスト

  • [ ] 目的に合った方式を選んだ
  • [ ] ローカルで WordPress の管理画面に入れた
  • [ ] 本番と PHP のバージョンをそろえた
  • [ ] テーマのフォルダをエディタで開けた
  • [ ] WP_DEBUG を有効にしてエラーを確認できる

WordPressのローカル環境の作り方のFAQ（よくある質問）

Q. パソコンの性能はどのくらい必要ですか？
A. ツールごとに条件が違うため、各ツールの公式ページで確認します。Docker 型は、Docker Desktop の動作条件も満たす必要があります。

Q. ローカル環境で作ったサイトを、そのまま公開できますか？
A. ファイルとデータベースを本番サーバーへ移せば公開できます。テーマだけなら、テーマのフォルダを本番へアップロードする方法が簡単です（自作テーマを本番サーバーに反映する方法｜ZIPアップロードとSFTP）。

Q. スマホで表示を確認できますか？
A. ローカル環境は基本的に自分のパソコンからしか見えません。ブラウザの開発者ツールのスマホ表示で確認するか、ツールの共有機能を使います。

筆者の見解（WordPressのローカル環境の作り方）

ローカル環境は「本番を壊さないための保険」であると同時に、気軽に壊して学べる場所だと考えます。最初はツール選びに時間をかけすぎず、手軽な方式で1つサイトを作り、テーマのファイルを1行変えて画面が変わる体験をするのが近道です。慣れてきたら、本番と同じ PHP バージョンにそろえることだけは早めに習慣にするのがよいと私は思います。

WordPressのローカル環境の作り方の関連項目

出典（一次情報）

タイトルとURLをコピーしました