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の書き出し機能などで内容を書き出しておきます。
参考資料
- @wordpress/envの変更履歴(12.1.0、2026年11月4日)
- Env: Add an experimental PHP runtime(#85512)
- @wordpress/envのREADME(Experimental runtimes、Runtime comparison)
- @wordpress/env 12.1.0(npm)
検証環境
- 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が調査と下書きを担当し、上記の環境で実際に動かして結果を確かめ、下書きとは別の担当が公開前に本文と出典を確認しています。制作と訂正の方針は編集・訂正方針で公開しています。











