wp-envをDockerなしで動かす|12.1.0の--runtime=phpで手元のPHPとSQLiteを使う手順と、付け忘れると環境が消える条件

wp-env 12.1.0で、Dockerなしの実行方式が加わった

WordPressのプラグインやテーマを作るときに、手元に開発用のWordPressを立てるコマンド「wp-env」(npmのパッケージ名は@wordpress/env)の12.1.0が、2026年11月4日に公開されました。WordPressのブロックエディターを開発するGutenbergのリポジトリで作られているツールで、これまではDockerのコンテナーでWordPressとデータベース(MariaDB)を動かすのが基本でした。

12.1.0の変更履歴には、Dockerを使わない実験的な実行方式「php」が加わったとあります(wp-envの変更履歴)。wp-env start --runtime=phpで起動すると、パソコンに入っているPHPの組み込みWebサーバーでWordPressを動かし、データベースにはSQLiteを使います。Dockerを使わない実行方式には、10.39.0(2026年1月29日)からある「Playground」(PHPをWebAssemblyで動かす方式)もあります。追加したプルリクエスト#85512は、理由として、Dockerは起動が遅く動かすのも重いこと、PlaygroundはPHPをWebAssemblyで動かすぶん目に見えて遅いことを挙げています。

この記事では、Node.js 24とPHP 8.4を入れたDockerのコンテナーの中でwp-env 12.1.0を動かし、起動から停止、リセットまでを確かめました。必要なもの、起動の速さ、使えない機能に加えて、--runtime=phpを付け忘れて起動すると開発環境のデータが消える条件を説明します。

要点

--runtime=phpで、WordPressの開発環境が2回目から1秒かからずに起動した

wp-env 12.1.0、PHP 8.4.27、WordPress 7.1.4で確かめた結果です。

必要なもの

pdo_sqliteが入ったPHP、Node.js 22.13以上、Git

Dockerは要りません。pdo_sqliteのないPHPやGitのない環境では、エラーで止まりました。

速さ

初回24秒、2回目0.8秒

初回はWordPressのダウンロードを含みます。プラグインのファイルを書き換えると、次の表示ですぐ反映されました。

付け忘れ

--runtime=phpなしのstartは、既定の答えで環境を消す

PHPの実行方式で使った環境を止めたあとにこう起動し、確認の問いにEnterで答えると、データベースごと消えました。npmスクリプトに書いておくと防げます。

使えない機能

wp-env run、マルチサイト、PHPの版の指定

READMEの比較表では、XdebugとphpMyAdminも使えないとされています。これらを使う作業はDockerの実行方式に残します。

必要なのは、pdo_sqliteが入ったPHP、Node.js 22.13以上、Git

PHPの実行方式は、パソコンに入っているPHPをそのまま使います。wp-envのREADMEは、PHPがPATHにあり、PHPからSQLiteを使うための拡張「pdo_sqlite」が有効になっていることを条件にしています。wp-env 12.0.0からはNode.js 22.13以上が必要で、READMEの前提条件にはGitもあります。

準備ができているかは、次のコマンドで確かめます。pdo_sqliteの行が出れば、PHPは使えます。

php --version
php -m | grep pdo_sqlite
node --version   # v22.13.0 以上
git --version

手元のコンテナーでは、DebianのPHP 8.4にphp8.4-cliとphp8.4-sqlite3を入れるとpdo_sqliteが有効になりました。php8.4-cliだけのPHPで起動すると、何もダウンロードしないうちに次のエラーで止まりました。

✖ PHP's pdo_sqlite extension is missing. Turn it on in php.ini or install it.

Gitも要ります。設定でWordPressの本体(core)を指定しないと、wp-envはWordPressをGitで取りにいきます。Gitを外したコンテナーでは✖ Error: spawn git ENOENTで止まりました。

Macでは、Homebrewのphp(2026年11月16日の時点で8.5.12)などでPHPを入れ、同じくphp -mでpdo_sqliteが出るかを確かめてから使います。

プラグインのフォルダーで--runtime=phpを付けて起動する

作っているプラグインのフォルダーに.wp-env.jsonを置き、そのフォルダーをプラグインとして読み込む設定にします。"testsEnvironment": falseは、テスト用のサイトを作らない指定です。書かないと、「既定でテスト用のサイトも作る動きは、今後の版でなくなる」という警告が出ました。

{
	"plugins": [ "." ],
	"testsEnvironment": false
}
npm i -g @wordpress/env@12.1.0
wp-env start --runtime=php
# WordPress development site started at http://localhost:8888
#  ✔ Done! (in 24s 38ms)

起動するとhttp://localhost:8888でWordPressが開き、ユーザー名admin、パスワードpasswordで管理画面に入れました。テスト用に作ったプラグインのREST APIのルートは、データベースがSQLiteになっていることを返しました。

$ curl "http://localhost:8888/?rest_route=/hello-negi/v1/ping"
{"message":"pong","php":"8.4.27","db":"sqlite","wp":"7.1.4"}

初回の起動

24.1秒

WordPressとSQLiteのプラグインのダウンロードを含む

2回目からの起動

0.8秒

停止したあとに--runtime=phpを付けて起動

停止(stop)

0.8秒

PHPの組み込みサーバーを止める

初期化(reset)

1.1秒

データベースをインストール直後に戻す

wp-env 12.1.0の起動・停止・初期化にかかった時間。2026年11月16日、Docker Desktop 4.79.0(macOS 27.0.1、Apple Silicon)のLinuxのコンテナー(Node.js 24.22.3、PHP 8.4.27、--init付き)で測った値。初回はダウンロードを含むので、回線の速さで変わります。READMEによると、WindowsではPHPの組み込みサーバーが要求を1つずつ処理するので、要求の多いページは遅くなります。

プラグインのフォルダーは、wp-envが作るWordPressのコピーのwp-content/pluginsにシンボリックリンクとしてつながっていました。プラグインのPHPファイルを書き換えると、起動し直さなくても次の表示で変更が反映されました。

データベースと画像などのアップロードは、ホームフォルダーの~/.wp-env/の下に作られる作業フォルダーに置かれます。wp-env resetはデータベースをインストール直後の状態に戻し、手元では作った投稿が消えて最初の「Hello world!」だけになりました。ポートを変えるときはWP_ENV_PORT=8890 wp-env start --runtime=phpのように指定し、8890で開けました。

Dockerの実行方式とは違い、テスト用のサイト(既定ではhttp://localhost:8889)はtestsEnvironmentを書かなかったときも起動しませんでした。起動時の警告の文面は、テスト用の環境には--configで別の設定ファイルを使うよう案内しています。

PHPの実行方式の環境は、--runtime=phpなしのstartでEnterを押すと消える

READMEには、一度ある実行方式で起動すると、そのあとのstopやdestroyは同じ実行方式を自動で使うとあります。ただしstartは別でした。PHPの実行方式で使っていた環境を止めたあと、--runtimeを付けずにwp-env startを実行すると、次の確認が出ました。

? Environment was previously started with 'php' runtime. Destroy it and start
with 'docker'? (Y/n)

「PHPの実行方式で作った環境を消して、Dockerの実行方式で始めるか」という問いで、括弧の中の大文字のYが既定の答えです。wp-env 12.1.0のソースでも、--runtimeを省いたときの実行方式はdocker、この確認の既定は「はい」になっていました。

Enter(既定の答え)を押した場合

PHPの実行方式の環境が消える

Removed WordPress environment.と表示され、作業フォルダーのWordPress、データベース、アップロードが消えました。作っているプラグインのフォルダーは残りました。続けてDockerの実行方式で始めようとし、Dockerのないコンテナーではエラーで止まりました。--runtime=phpで起動し直すと新しくインストールされ、作っていた投稿はありませんでした。

nと答えた場合

何も消えずに止まる

✖ Aborted. Run 'wp-env destroy' manually or start with '--runtime=php'.と表示されて終わり、作業フォルダーはそのまま残りました。

PHPの実行方式で使った環境を止めてから、--runtimeなしでwp-env startを実行し、確認に答えた結果。2026年11月16日、wp-env 12.1.0のコンテナーで確認。標準入力に何もつながっていないとき(< /dev/null)はCancelled.で終わり、何も消えませんでした。改行をパイプで渡すと既定の答えとして受け取られ、環境が消えました。Dockerが動いているパソコンでは、消したあとにDockerの実行方式での起動へ進む処理になっています(wp-env 12.1.0のlib/commands/start.js)。

起動するたびに--runtime=phpを打つ代わりに、package.jsonのnpmスクリプトに書いておくと、付け忘れを防げます。npm run env:startで起動すると、1秒かからずにPHPの実行方式のまま立ち上がりました。

{
  "scripts": {
    "env:start": "wp-env start --runtime=php",
    "env:stop": "wp-env stop",
    "env:reset": "wp-env reset"
  }
}

PHPの実行方式では、wp-env run、マルチサイト、PHPの版の指定は使えない

PHPの実行方式は実験的な機能で、Dockerの実行方式でできることの一部がまだ使えません。手元で試した結果は次のとおりです。

wp-env run(WP-CLIなどのコマンドの実行)

エラーで止まります。PHPの実行方式でも、文言は「Playground runtime」になっていました。

✖ The 'run' command is not supported in the Playground runtime at the moment.

"multisite": true(マルチサイト)

起動の前にエラーで止まります。

✖ Multisite is not supported with the PHP runtime yet.

"phpVersion": "8.3"(PHPの版の指定)

警告を出して起動し、入っているPHP 8.4.27のまま動きました。

⚠ The PHP runtime does not support "phpVersion" yet; it uses the installed PHP as it is.

wp-env logs(ログの表示)

PHPの組み込みサーバーのアクセスログが表示されました。--watchを付けても、ログを追い続けずにすぐ終わりました。

PHPの実行方式で、それぞれのコマンドと設定を試した結果。2026年11月16日、wp-env 12.1.0とPHP 8.4.27のコンテナーで確認。

READMEの機能の比較表では、ほかにXdebug、SPXによる性能の計測、phpMyAdmin、MariaDBの版の指定もPHPの実行方式では使えないとしています。データベースはSQLiteなので、MySQLやMariaDBに固有の動きを確かめる作業にも向きません。Playgroundの実行方式は、READMEの比較表ではマルチサイト、Xdebug、PHPの版の指定に対応しています。

速さが要る作業はPHPの実行方式、MySQLやXdebugが要る作業はDockerで分ける

PHPの実行方式は、プラグインやテーマのコードを書いて画面で確かめる作業を、Dockerを動かさずに素早く繰り返すのに向いています。プルリクエスト#85512では、作成者の手元での比較として、Gutenbergの段落ブロックと文字入力(writing flow)のE2Eテストが、PHPの組み込みサーバーで57秒、Playgroundの実行方式で2.1分かかったと書いています。

PHPの実行方式(--runtime=php)

コードを書いて画面で確かめる作業

  • Docker Desktopを入れられない、動かしたくない
  • 起動と停止を何度も繰り返す
  • 手元のPHPの版で動けばよい

Dockerの実行方式(既定)

本番に近い条件で確かめる作業

  • MySQL・MariaDB、マルチサイトで確かめる
  • Xdebugでステップ実行する、複数のPHPの版で試す
  • wp-env runでWP-CLIを使う

同じプラグインのフォルダーで実行方式を切り替えるときは、前の実行方式の環境を消すことになります。データベースの中身を残したいときは、切り替える前にWordPressの書き出し機能などで内容を書き出しておきます。

参考資料

検証環境

  • macOS 27.0.1(Apple Silicon)、Docker Desktop 4.79.0(Docker Engine 29.5.3)のコンテナー(Debian trixie、Node.js 24.22.3、Git 2.47.3)
  • PHP 8.4.27(Debianのphp8.4-cli・php8.4-sqlite3)、@wordpress/env 12.1.0、WordPress 7.1.4
  • 検証日: 2026年11月16日

この記事は、AIが調査と下書きを担当し、上記の環境で実際に動かして結果を確かめ、下書きとは別の担当が公開前に本文と出典を確認しています。制作と訂正の方針は編集・訂正方針で公開しています。